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A SYSTEM, METHOD AND ARTICLE OF MANUFACTURE FOR A SIMULATION ENABLED RETAIL 



MANAGEMENT TUTORIAL SYSTEM 


Field Of The Invention 


^ The present invention relates to education systems and more particularly to a rule based tutorial system that utilizes 
business simulations of a retail environment to teach new store management skills. 


When building a knowledge based system or expert system, at least two disciplines are necessary to properly construct 
the rules that drive the knowledge base, the discipline of the knowledge engineer and the knowledge of the expert. The domain 
expert has knowledge of the domain or field of use of the expert system. For example, the domain expert of an expert for 
instructing students in an automotive manufacturing facility might be a process control engineer while the domain expert for a 
medical instruction system might be a doctor or a nurse. The knowledge engineer is a person that understands the expert system 
and utilizes the expert's knowledge to create an application for the system. In many instances, the knowledge engineer and 
domain expert are separate people who have to collaborate to construct the expert system. 

Typically, this collaboration takes the form of the knowledge engineer asking questions of the domain expert and 
incorporating the answers to these questions into the design of the system. This approach is labor intensive, slow and error 
prone. The coordination of the two separate disciplines may lead to problems. Although the knowledge engineer can transcribe 
input from the expert utilizing videotape, audio tape, text and other sources, efforts from people of both disciplines have to be 
expended. Further, if the knowledge engineer does not ask the right questions or asks the questions in an incorrect way, the 
information utilized to design the knowledge base could be incorrect. Feedback to the knowledge engineer from the expert 
system is often not available in prior art system until the construction is completed. With conventional system, there is a time 
consuming feedback loop that ties together various processes from knowledge acquisition to validation. 

Educational systems utilizing an expert system component often suffer from a lack of motivational aspects that result in 
a user becoming bored or ceasing to complete a training program. Current training programs utilize static, hard-coded feedback 
with some linear video and graphics used to add visual appeal and illustrate concepts. These systems typically support one 
"correct 11 answer and navigation through the system is only supported through a single defined path which results in a two- 
dimensional generic interaction, with no business model support and a single feedback to the learner of correct or incorrect 
based on the selected response. Current tutorial systems do not architect real business simulations into the rules to provide a 
creative learning environment to a user. 


According to a broad aspect of a preferred embodiment of the invention, a goal based learning system utilizes a rule 
based expert training system to provide a cognitive educational experience. The system provides the user with a simulated 
environment that presents a business opportunity to understand and solve optimally. Mistakes are noted and remedial 
educational material presented dynamically to build the necessary skills that a user requires for success in the business 
endeavor. The system utilizes an artificial intelligence engine driving individualized and dynamic feedback with synchronized 
video and graphics used to simulate real-world environment and interactions. Multiple "correct" answers are integrated into the 
learning system to allow individualized learning experiences in which navigation through the system is at a pace controlled by the 
learner, A robust business model provides support for realistic activities and allows a user to experience real world 
consequences for their actions and decisions and entails realtime decision-making and synthesis of the educational material, A 
dynamic feedback system is utilized that narrowly tailors feedback and focuses it based on the performance and characteristics 
of the student to assist the student in reaching a predefined goal. A store management tutorial system is enabled for providing 
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active coaching on aspects of inventory management, stocking, advertising, return on revenue, markdown, assortment strategy 
and other aspects of retail management. Techniques for process sensitive help are also integrated into the system to provide 
contextual examples to guide a user in performing a task. 

DESCRIPTION OF THE DRAWINGS 

The foregoing and other objects, aspects and advantages are better understood from the following detailed description 
of a preferred embodiment of the invention with reference to the drawings, in which: 

Figure 1 is a block diagram of a representative hardware environment in accordance with a preferred embodiment; 

Figure 2 is a block diagram of a system architecture in accordance with a preferred embodiment; 

Figure 3 depicts the timeline and relative resource requirements for each phase of development for a typical application 
development in accordance with a preferred embodiment; 

Figure 4 illustrates a small segment of a domain model for claims handlers in the auto insurance industry in 
accordance with a preferred embodiment; 

Figure 5 illustrates an insurance underwriting profile in accordance with a preferred embodiment; 

Figure 6 illustrates a transformation component in accordance with a preferred embodiment; 

Figure 7 illustrates the use of a toolbar to navigate and access application level features in accordance with a preferred 
embodiment; 

Figure 8 is a GBS display in accordance with a preferred embodiment; 
Figure 9 is a feedback display in accordance with a preferred embodiment; 
Figure 10 illustrates a journal entry simulation in accordance .with a preferred embodiment; 
Figure 11 illustrates a simulated Bell Phone Bill journal entry in accordance with a preferred embodiment; 
Figure 12 illustrates a feedback display in accordance with a preferred embodiment; 
Figure 13 illustrates the steps of the first scenario in accordance with a preferred embodiment; 
Figure 14 and 15 illustrate the steps associated with a build scenario in accordance with a preferred embodiment; 
Figure 16 illustrates a test scenario in accordance with a preferred embodiment. The test students work through the 
journalization activity; 

Figure 17 illustrates how the tool suite supports student administration in accordance with a preferred embodiment; 
Figure 18 illustrates a suite to support a student interaction in accordance with a preferred embodiment; 
Figure 19 illustrates the remediation process in accordance with a preferred embodiment; 
Figure 20 illustrates the objects for the journalization task in accordance with a preferred embodiment; 
Figure 21 illustrates the mapping of a source item to a target item in accordance with a preferred embodiment; 
Figure 22 illustrates an analysis of rules in accordance with a preferred embodiment; 
Figure 23 illustrates a feedback selection in accordance with a preferred embodiment; 
Figure 24 is a flowchart of the feedback logic in accordance with a preferred embodiment; 
Figure 25 is a block diagram setting forth the architecture of a simulation model in accordance with a preferred 
embodiment; 

Figure 26 illustrates the steps for configuring a simulation in accordance with a preferred embodiment; 
Figure 27 is a block diagram presenting the detailed architecture of a system dynamics model in accordance with a 
preferred embodiment; 
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Figure 28 is an overview diagram of the logic utilized for initial configuration in accordance with a preferred 
embodiment; 

Figure 29 is a display of video information in accordance with a preferred embodiment; and 
Figure 30 illustrates an ICA utility in accordance with a preferred embodiment. 


DETAILED DESCRIPTION 

A preferred embodiment of a system in accordance with the present invention is preferably practiced in the context of a 
personal computer such as an IBM compatible personal computer, Apple Macintosh computer or UNIX based workstation. A 
representative hardware environment is depicted in Figure 1, which illustrates a typical hardware configuration of a workstation in 
accordance with a preferred embodiment having a central processing unit 110, such as a microprocessor, and a number of other 
units interconnected via a system bus 112. The workstation shown in Figure 1 includes a Random Access Memory (RAM) 114, 
Read Only Memory (ROM) 1 16, an I/O adapter 1 18 for connecting peripheral devices such as disk storage units 120 to the bus 
112, a user interface adapter 122 for connecting a keyboard 124, a mouse 126, a speaker 128, a microphone 132, and/or other 
user interface devices such as a touch screen (not shown) to the bus 1 1 2, communication adapter 1 34 for connecting the 
workstation to a communication network (e.g., a data processing network) and a display adapter 136 for connecting the bus 112 
to a display device 138. The workstation typically has resident thereon an operating system such as the Microsoft Windows NT or 
Windows/95 Operating System (OS), the IBM OS/2 operating system, the MAC OS, or UNIX operating system. Those skilled in 
the art will appreciate that the present invention may also be implemented on platforms and operating systems other than those 
mentioned. 

A preferred embodiment is written using JAVA, C, and the C++ language and utilizes object oriented programming 
methodology. Object oriented programming (OOP) has become increasingly used to develop complex applications. As OOP 
moves toward the mainstream of software design and development, various software solutions require adaptation to make use of 
the benefits of OOP. A need exists for these principles of OOP to be applied to a messaging interface of an electronic messaging 
system such that a set of OOP classes and objects for the messaging interface can be provided. A simulation engine in 
accordance with a preferred embodiment is based on a Microsoft Visual Basic component developed to help design and test 
feedback in relation to a Microsoft Excel spreadsheet. These spreadsheet models are what simulate actual business functions 
and become a task that will be performed by a student The Simulation Engine accepts simulation inputs and calculates various 
outputs and notifies the system of the status of the simulation at a given time in order to obtain appropriate feedback. 

Relationship of Components 

The simulation model executes the business function that the student is learning and is therefore the center point of the 
application. An activity 'layer' allows the user to visually guide the simulation by passing inputs into the simulation engine and 
receiving an output from the simulation model. For example, if the student was working on an income statement activity, the net 
sales and cost of goods sold calculations are passed as inputs to the simulation model and the net income value is calculated 
and retrieved as an output. As calculations are passed to and retrieved from the simulation model, they are also passed to the 
Intelligent Coaching Agent (ICA). The ICA analyzes the Inputs and Outputs to the simulation model and generates feedback 
based on a set of rules. This feedback is received and displayed through the Visual Basic Architecture. 

Figure 2 is a block diagram of a system architecture in accordance with a preferred embodiment. The Presentation 
'layer' 210 is separate from the activity 'layer' 220 and communication is facilitated through a set of messages 230 that control 
the display specific content topics. A preferred embodiment enables knowledge workers 200 & 201 to acquire complex skills 
rapidly, reliably and consistently across an organization to deliver rapid acquisition of complex skills. This result is achieved by 
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placing individuals in a simulated business environment that "looks and feels" like real work, and challenging them to make 
decisions which support a business' strategic objectives utilizing highly effective learning theory (e.g., goal based learning, learn 
by doing, failure based learning, etc.), and the latest in multimedia user interfaces, coupled with three powerful, integrated 
software components. The first of these components is a software Solution Construction Aid (SCA) 230 consisting of a 
mathematical modeling tool 234 which simulates business outcomes of an individual's collective actions over a period of time. 
The second component is a knowledge system 250 consisting of an HTML content layer which organizes and presents packaged 
knowledge much like an online text book with practice exercises, video war stories, and a glossary. The third component is a 
software tutor 270 comprising an artificial intelligence engine 240 which generates individualized coaching messages based on 
decisions made by learner. 

Feedback is unique for each individual completing the course and supports client cultural messages 242 "designed 
into" the course. A business simulation methodology that includes support for content acquisition, story line design, interaction 
design, feedback and coaching delivery, and content delivery is architected into the system in accordance with a preferred 
embodiment. A large number of "pre-designed" learning interactions such as drag and drop association of information 238, 
situation assessment/action planning, interviewing (one-on-one, one-to-many), presenting (to a group of experts/executives), 
metering of performance (handle now, handle later), "time jumping" for impact of decisions, competitive landscape shift (while 
"time jumping", competitors merge, customers are acquired, etc.) and video interviewing with automated note taking are also 
included in accordance with a preferred embodiment. 

Business simulation in accordance with a preferred embodiment delivers training curricula in an optimal manner. This 
is because such applications provide effective training that mirrors a student's actual work environment. The application of skills 
"on the job" facilitates increased retention and higher overall job performance. While the results of such training applications are 
impressive, business simulations are very complex to design and build correctly. These simulations are characterized by a very 
open-ended environment, where students can go through the application along any number of paths, depending on their learning 
style and prior experiences/knowledge. 

A category of learning approaches called Learn by Doing, is commonly used as a solution to support the first phase 
(Learn) of the Workforce Performance Cycle. However, it can also be a solution to support the second phase (Perform) of the 
cycle to enable point of need learning during job performance. By adopting the approach presented, some of the benefits of a 
technology based approach for building business simulation solutions which create more repeatable, predictable projects 
resulting in more perceived and actual user value at a lower cost and in less time are highlighted. 

Most corporate training programs today are misdirected because they have failed to focus properly on the purpose of 
their training. These programs have confused the memorization of facts with the ability to perform tasks; the knowing of "that" 
with the knowing of "how". By adopting the methods of traditional schools, businesses are teaching a wide breadth of 
disconnected, decontextualized facts and figures, when they should be focused on improved performance. How do you teach 
performance, when lectures, books, and tests inherently are designed around facts and figures? Throw away the lectures, 
books, and tests. The best way to prepare for high performance is to perform; experience is the best teacher! Most business 
leaders agree that workers become more effective the more time they spend in their jobs. The best approach for training novice 
employees, therefore, would be letting them learn on the job, acquiring skills in their actual work environment The idea of 
learning-by-doing is not revolutionary, yet it is resisted in business and academia. Why is this so, if higher competence is 
universally desired? 

Learners are reluctant to adopt learning-by-doing because they are frightened of failure. People work hard to avoid 
making mistakes in front of others. Business leaders are hesitant to implement learning-by-doing because novice failure may 
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have dramatic safety, legal and financial implications. Imagine a novice pilot learning-by-doing as he accelerates a large jet plane 
down a runway; likewise, consider a new financial analyst learning-by-doing as he structures a multi-million dollar financial loan. 
Few employers are willing to endure such failures to have a more competent workforce. 

The key to such a support system is that it is seamlessly integrated into the business system that the knowledge 
5 worker uses to execute their job tasks. Workers don't need to go "off-line" or seek out cryptic information buried within paper 
manuals and binders for guidance or to find the answer to queries. All the support components are made available through the 
same applications the worker's use, at the point in which they need them, tailored to the individual to show "how", not just "what". 
Learning would be occurring all the time, with little distinction between performing and improving performance. Establishing that 
training should focus on performance (how), rather than facts (what), and extending the model of learning to include assistance 
10 while performing, rather than only before performance, still leaves us dangerously exposed in preparing to compete in the new, 
chaotic economy. As was mentioned in the opening of this paper, the pace of change in business today is whiplash fast. Not only 
are new methods of doing business evolving every 18-24 months, new competitors emerge, dominate, and fade in time periods 
businesses used to take to perform demographic studies. Now more than ever, those who do not reinvent themselves on a 
regular basis will be fossilized by the pace of change. A typical BusSim engagement takes between one and two years to 
_ 15 complete and requires a variety of both functional and technical skills. Figure 3 depicts the timeline and relative resource 
J I requirements for each phase of development for a typical application development in accordance with a preferred embodiment. 

SJ The chart clearly depicts the relationship between the large number of technical resources required for both the build and test 

9i phases of development. This is because the traditional development process used to build BusSim solutions reflects more of a 

"one off" philosophy, where development is done from scratch in a monolithic fashion, with little or no reuse from one application 
S| 20 to the next. This lack of reuse makes this approach prohibitively expensive, as well as lengthy, for future BusSim projects. 
® The solution to this problem is to put tools in the hands of instructional designers that allows them to create their 

PS BusSim designs and implement them without the need for programmers to write code. And to put application architectures that 

Cm integrate with the tools in the hands of developers, providing them with the ability to quickly deliver solutions for a number of 

LH different platforms. The reuse, then, comes in using the tools and architectures from one engagement to another. Both functional 

□ 25 and technical resources carry with them the knowledge of how to use the technology, which also has an associated benefit of 
M establishing a best-practice development methodology for BusSim engagements. 

Development Cycle Activities 
In the Design Phase, instructional designers become oriented to the content area and begin to conceptualize an 
instructional approach. They familiarize themselves with the subject matter through reading materials and interviews with Subject 
30 Matter Experts (SMEs). They also identify learning objectives from key client contacts. Conceptual designs for student 

interactions and interface layouts also begin to emerge. After the conceptual designs have taken shape, Low-Fi user testing 
(a.k.a. Conference Room Piloting) is performed. Students interact with interface mock-ups while facilitators observe and record 
any issues. Finally, detailed designs are created that incorporate findings. These detailed designs are handed off to the 
development team for implementation. The design phase has traditionally been fraught with several problems. Unlike a traditional 
35 business system, BusSim solutions are not rooted in tangible business processes, so requirements are difficult to identify in a 
concrete way. This leaves instructional designers with a 'blue sky' design problem. With few business-driven constraints on the 
solution, shallow expertise in the content area, and limited technical skills, instructional designers have little help in beginning a 
design. Typically, only experienced designers have been able to conjure interface, analysis, and feedback designs that meet the 
learning objectives yet remain technically feasible to implement. To compound the problem, BusSim solutions are very open 
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ended in nature. The designer must anticipate a huge combination of student behavior to design feedback that is helpful and 
realistic. 

During the build phase, the application development team uses the detailed designs to code the application. Coding 
tasks include the interfaces and widgets that the student interacts with. The interfaces can be made up of buttons, grids, check 
boxes, or any other screen controls that allow the student to view and manipulate his deliverables. The developer must also code 
logic that analyzes the student's work and provides feedback interactions. These interactions may take the form of text and/or 
multimedia feedback from simulated team members, conversations with simulated team members, or direct manipulations of the 
student's work by simulated team members. In parallel with these coding efforts, graphics, videos, and audio are being created 
for use in the application. Managing the development of these assets have their own complications. Risks in the build phase 
include misinterpretation of the designs. If the developer does not accurately understand the designer's intentions, the application 
will not function as desired. Also, coding these applications requires very skilled developers because the logic that analyzes the 
student's work and composes feedback is very complex. 

The Test Phase, as the name implies, is for testing the application. Testing is performed to verify the application in 
three ways: first that the application functions properly (functional testing), second that the students understand the interface and 
can navigate effectively (usability testing), and third that the learning objectives are met (cognition testing). Functional testing of 
the application can be carried out by the development team or by a dedicated test team. If the application fails to function 
properly, it is debugged, fixed, recompiled and retested until its operation is satisfactory. Usability and cognition testing can only 
be carried out by test students who are unfamiliar with the application. If usability is unsatisfactory, parts of the interface and or 
feedback logic may need to be redesigned, recoded, and retested. If the learning objectives are not met, large parts of the 
application may need to be removed and completely redeveloped fronrva different perspective. The test phase is typically where 
most of the difficulties in the BusSim development cycle are encountered. The process of discovering and fixing functional, 
usability, and cognition problems is a difficult process and not an exact science. 

For functional testing, testers operate the application, either by following a test script or by acting spontaneously and 
documenting their actions as they go. When a problem or unexpected result is encountered, it too is documented. The 
application developer responsible for that part of the application then receives the documentation and attempts to duplicate the 
problem by repeating the tester's actions. When the problem is duplicated, the developer investigates further to find the cause 
and implement a fix. The developer once again repeats the tester's actions to verify that the fix solved the problem. Finally, all 
other test scripts must be rerun to verify that the fix did not have unintended consequences elsewhere in the application. The 
Execution Phase refers to the steady state operation of the completed application in its production environment. For some 
clients, this involves phone support for students. Clients may also want the ability to track students' progress and control their 
progression through the course. Lastly, clients may want the ability to track issues so they may be considered for inclusion in 
course maintenance releases. 

One of the key values of on-line courses is that they can be taken at a time, location, and pace that is convenient for 
the individual student. However, because students are not centrally located, support is not always readily available. For this 
reason it is often desirable to have phone support for students. Clients may also desire to track students' progress, or control 
their advancement through the course. Under this strategy, after a student completes a section of the course, he will transfer his 
progress data to a processing center either electronically or by physically mailing a disk. There it can be analyzed to verify that 
he completed all required work satisfactorily. One difficulty commonly associated with student tracking is isolating the student 
data for analysis. It can be unwieldy to transmit all the course data, so it is often imperative to isolate the minimum data required 
to perform the necessary analysis of the student's progress. 
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A Delivery Framework for Business Simulation 

As discussed earlier, the traditional development process used to build BusSim solutions reflects more of a "one off" 
philosophy, where development is done from scratch in a monolithic fashion, with little or no reuse from one application to the 
next. A better approach would be to focus on reducing the total effort required for development through reuse, which, in turn 
5 would decrease cost and development time. The first step in considering reuse as an option is the identification of common 
aspects of the different BusSim applications that can be generalized to be useful in future applications. In examination of the 
elements that make up these applications, three common aspects emerge as integral parts of each: Interface, Analysis and 
Interpretation. Every BusSim application must have a mechanism for interaction with the student. The degree of complexity of 
each interface may vary, from the high interactivity of a high-fidelity real-time simulation task, to the less complex information 
10 delivery requirements of a business case background information task. Regardless of how sophisticated the User interface (Ul), 
it is a vital piece of making the underlying simulation and feedback logic useful to the end user. 

Every BusSim application does analysis on the data that defines the current state of the simulation many times 
throughout the execution of the application. This analysis is done either to determine what is happening in the simulation, or to 
perform additional calculations on the data which are then fed back into the simulation. For example, the analysis may be the 
a «% 1 5 recognition of any actions the student has taken on artifacts within the simulated environment (notebooks, number values, 
J| interviews conducted, etc.), or it may be the calculation of an ROI based on numbers the student has supplied. Substantive, 

useful feedback is a critical piece of any BusSim application. It is the main mechanism to communicate if actions taken by the 
student are helping or hurting them meet their performance objectives. The interpretation piece of the set of proposed 
Ms commonalties takes the results of any analysis performed and makes sense of it. It takes the non-biased view of the world that 

5 20 the Analysis portion delivers (i.e., "Demand is up 3%") and places some evaluative context around it (i.e., "Demand is below the 
™ expected 7%; you're in trouble!", or "Demand has exceeded projections of 1 .5%; Great job!"), 

p There are several approaches to capturing commonalties for reuse. Two of the more common approaches are 

J; framework-based and component-based. To help illustrate the differences between the two approaches, we will draw an analogy 

between building an application and building a house. One can construct a house from scratch, using the raw materials, 2x4s, 
Q 25 nails, paint, concrete, etc. One can also construct an application from scratch, using the raw materials of new designs and new 
^ code. The effort involved in both undertakings can be reduced through framework-based and/or component-based reuse. Within 

the paradigm of framework-based reuse, a generic framework or architecture is constructed that contains commonalties. In the 
house analogy, one could purchase a prefabricated house framework consisting of floors, outside walls, bearing walls and a roof. 
The house can be customized by adding partition walls, wall-paper, woodwork, carpeting etc. Similarly, prefabricated application 
30 frameworks are available that contain baseline application structure and functionality. Individual applications are completed by 
adding specific functionality and customizing the look-and-feel. An example of a commonly used application framework is 
Microsoft Foundation Classes. It is a framework for developing Windows applications using C++. MFC supplies the base 
functionality of a windowing application and the developer completes the application by adding functionality within the framework. 
Framework-based reuse is best suited for capturing template-like features, for example user interface management, procedural 
35 object behaviors, and any other features that may require specialization. Some benefits of using a framework include: 

Extensive functionality can be incorporated into a framework. In the house analogy, if I know I am going to build a 
whole neighborhood of three bedroom ranches, I can build the plumbing, wiring, and partition walls right into the framework, 
reducing the incremental effort required for each house. If I know i am going to build a large number of very similar applications, 
they will have more commonalties that can be included in the framework rather than built individually. 
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Applications can override the framework-supplied functionality wherever appropriate. If a house framework 
came with pre-painted walls, the builder could just paint over them with preferred colors. Similarly, the object oriented principle of 
inheritance allows an application developer to override the behavior of the framework. In the paradigm of component-based 
reuse, key functionality is encapsulated in a component. The component can then be reused in multiple applications. In the 
house analogy, components correspond to appliances such as dishwashers, refrigerators, microwaves, etc. Similarly, many 
application components with pre-packaged functionality are available from a variety of vendors. An example of a popular 
component is a Data Grid. It is a component that can be integrated into an application to deliver the capability of viewing 
columnar data in a spreadsheet-like grid. Component-based reuse is best suited for capturing black-box-like features, for 
example text processing, data manipulation, or any other features that do not require specialization. 

Several applications on the same computer can share a single component. This is not such a good fit with the 
analogy, but imagine if all the houses in a neighborhood could share the same dishwasher simultaneously. Each home would 
have to supply its own dishes, detergent, and water, but they could all wash dishes in parallel. In the application component 
world, this type of sharing is easily accomplished and results in reduced disk and memory requirements. 

Components tend to be less platform and tool dependent. A microwave can be used in virtually any house, 
whether it's framework is steel or wood, and regardless of whether it was customized for building mansions or shacks. You can 
put a high-end microwave in a low-end house and vice-versa. You can even have multiple different microwaves in your house. 
Component technologies such as CORBA, COM, and Java Beans make this kind of flexibility commonplace in application 
development. Often, the best answer to achieving reuse is through a combination of framework-based and component-based 
techniques. A framework-based approach for building BusSim applications is appropriate for developing the user interface, 
handling user and system events, starting and stopping the apptication T .and other application-specific and delivery platform- 
specific functions. A component-based approach is appropriate for black-box functionality. That is, functionality that can be used 
as-is with no specialization required. In creating architectures to support BusSim application development, it is imperative that 
any assets remain as flexible and extensible as possible or reusability may be diminished. Therefore, we chose to implement the 
unique aspects of BusSim applications using a component approach rather than a framework approach. This decision is further 
supported by the following observations. 

Delivery Framework for Business Simulation 

Components are combined with an Application Framework and an Application Architecture to achieve maximum reuse 
and minimum custom development effort. The Application Architecture is added to provide communication support between the 
application interface and the components, and between the components. This solution has the following features: The 
components (identified by the icons) encapsulate key BusSim functionality. The Application Architecture provides the glue that 
allows application-to-component and component-to-component communication. The Application Framework provides structure 
and base functionality that can be customized for different interaction styles. Only the application interface must be custom 
developed. The next section discusses each of these components in further detail. 

The Business Simulation Toolset 

We have clearly defined why a combined component/framework approach is the best solution for delivering high- 
quality BusSim solutions at a lower cost. Given that there are a number of third party frameworks already on the market that 
provide delivery capability for a wide variety of platforms, the TEL project is focused on defining and developing a set of 
components that provide unique services for the development and delivery of BusSim solutions. These components along with a 
set of design and test workbenches are the tools used by instructional designers to support activities in the four phases of 
BusSim development. We call this suite of tools the Business Simulation Toolset. Following is a description of each of the 
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components and workbenches of the toolset. A Component can be thought of as a black box that encapsulates the behavior 
and data necessary to support a related set of services. It exposes these services to the outside world through published 
interfaces. The published interface of a component allows you to understand what it does through the services it offers, but not 
how it does it The complexity of its implementation is hidden from the user. The following are the key components of the BusSim 
Toolset. Domain Component - provides services for modeling the state of a simulation. Profiling Component - provides services 
for rule-based evaluating the state of a simulation. Transformation Component - provides services for manipulating the state of a 
simulation. Remediation Component - provides services for the rule-based delivering of feedback to the student The Domain 
Model component is the central component of the suite that facilitates communication of context data across the application and 
the other components. It is a modeling tool that can use industry-standard database such as Informix, Oracle, or Sybase to store 
its data. A domain model is a representation of the objects in a simulation. The objects are such pseudo tangible things as a 
lever the student can pull, a form or notepad the student fills out, a character the student interacts with in a simulated meeting, 
etc. They can also be abstract objects such as the ROI for a particular investment, the number of times the student asked a 
particular question, etc. These objects are called entities. Some example entities include: Vehicles, operators and incidents in 
an insurance domain; Journal entries, cash flow statements and balance sheets in a financial accounting domain and Consumers 
and purchases in a marketing domain. 

An entity can also contain other entities. For example, a personal bank account entity might contain an entity that 
represents a savings account. Every entity has a set of properties where each property in some way describes the entity. The 
set of properties owned by an entity, in essence, define the entity. Some example properties include: An incident entity on an 
insurance application owns properties such as "Occurrence Date", Incident Type Code", etc. A journal entry owns properties 
such as "Credit Account", "Debit Account", and "Amount" ; and a revolving credit account entity on a mortgage application owns 
properties such as "Outstanding Balance", "Available Limit", etc. Figure 4 llustrates a small segment of a domain model for claims 
handlers in the auto insurance industry in accordance with a preferred embodiment. 

Profiling Component 

In the simplest terms, the purpose of the Profiling Component is to analyze the current state of a domain and identify 
specific things that are true about that domain. This information is then passed to the Remediation Component which provides 
feedback to the student. The Profiling Component analyzes the domain by asking questions about the domain's state, akin to an 
investigator asking questions about a case. The questions that the Profiler asks are called profiles. For example, suppose there 
is a task about building a campfire and the student has just thrown a match on a pile of wood, but the fire didn't start. In order to 
give useful feedback to the student, a tutor would need to know things like: was the match lit?, was the wood wet?, was there 
kindling in the pile?, etc. These questions would be among the profiles that the Profiling Component would use to analyze the 
domain. The results of the analysis would then be passed off to the Remediation Component which would use this information to 
provide specific feedback to the student. Specifically, a profiie is a set of criteria that is matched against the domain. The 
purpose of a profile is to check whether the criteria defined by the profile is met in the domain. Using a visual editing tool, 
instructional designers create profiles to identify those things that are important to know about the domain for a given task. 
During execution of a BusSim application at the point that feedback is requested either by the student or pro-actively by the 
application, the set of profiles associated with the current task are evaluated to determine which ones are true. Example profiles 
include: Good productions strategy but wrong Break-Even Formula; Good driving record and low claims history; and Correct 
Cash Flow Analysis but poor Return on Investment (ROI) 

A profile is composed of two types of structures: characteristics and collective characteristics. A characteristic is a 
conditional (the //half of a rule) that identifies a subset of the domain that is important for determining what feedback to deliver to 
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the student. Example characteristics include: Wrong debit account in transaction 1 ; Perfect cost classification; At Least 1 DUI in 
the last 3 years; More than $4000 in claims in the last 2 years; and More than two at-fault accidents in 5 years 
A characteristic's conditional uses one or more atomics as the operands to identify the subset of the domain that defines the 
characteristic. An atomic only makes reference to a single property of a single entity in the domain; thus the term atomic. 
Example atomics include: The number of DUI's >= 1; ROI > 10%; and Income between $75,000 and $1 10,000. A collective 
characteristic is a conditional that uses multiple characteristics and/or other collective characteristics -as its operands. Collective 
characteristics allow instructional designers to build richer expressions (i.e., ask more complex questions). Example collective 
characteristics include: Bad Household driving record; Good Credit Rating; Marginal Credit Rating; Problems with Cash for 
Expense transactions; and Problems with Sources and uses of cash. Once created, designers are able to reuse these elements 
within multiple expressions, which significantly eases the burden of creating additional profiles. When building a profile from its 
elements, atomics can be used by multiple characteristics, characteristics can be used by multiple collective characteristics and 
profiles, and collective characteristics can be used by multiple collective characteristics and profiles. Figure 5 illustrates an 
insurance underwriting profile in accordance with a preferred embodiment. 

Example Profile for Insurance Underwriting 
Transformation Component • Whereas the Profiling Component asks questions about the domain, the 
Transformation Component performs calculations on the domain and feeds the results back into the domain for further analysis 
by the Profiling Component. This facilitates the modeling of complex business systems that would otherwise be very difficult to 
implement as part of the application. Within the Analysis phase of the Interface/Analysis/lnterpretation execution flow, the 
Transformation Component actually acts on the domain before the Profiling Component does its analysis. The Transformation 
Component acts as a shell that wraps one or more data modeling components for the purpose of integrating these components 
into a BusSim application. The Transformation Component facilitates the transfer of specific data from the domain to the data 
modeling component (inputs) for calculations to be performed on the data, as well as the transfer of the results of the calculations 
from the data modeling component back to the domain (outputs). Figure 6 illustrates a transformation component in accordance 
with a preferred embodiment. The data modeling components could be third party modeling environments such as spreadsheet- 
based modeling (e.g., Excel, Formulal) or discrete time-based simulation modeling (e.g., PowerSim, VenSim). The components 
could also be custom built in C++, VB, Access, or any tool that is ODBC compliant to provide unique modeling environments. 
Using the Transformation Component to wrap a third party spreadsheet component provides an easy way of integrating into an 
application spreadsheet-based data analysis, created by such tools as Excel. The Transformation Component provides a shell 
for the spreadsheet so that it can look into the domain, pull out values needed as inputs, performs its calculations, and post 
outputs back to the domain. 

For example, if the financial statements of a company are stored in the domain, the domain would hold the baseline 
data like how much cash the company has, what its assets and liabilities are, etc. The Transformation Component would be able 
to look at the data and calculate additional values like cash flow ratios, ROI or NPV of investments, or any other calculations to 
quantitatively analyze the financial health of the company. Depending on their complexity, these calculations could be performed 
by pre-existing spreadsheets that a client has already spent considerable time developing. 

Remediation Component - The Remediation Component is an expert system that facilitates integration of intelligent 
feedback into BusSim applications. It has the following features: Ability to compose high quality text feedback; Ability to compose 
multimedia feedback that includes video and/or audio; Ability to include reference material in feedback such as Authorware 
pages or Web Pages and Ability to actively manipulate the users deliverables to highlight or even fix users' errors. A proven 
remediation theory embedded in its feedback composition algorithm allows integration of digital assets into the Remediation of a 
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training or IPS application. The Remediation model consists of three primary objects: Concepts; Coach Topics and Coach Items. 
Concepts are objects that represent real-world concepts that the user will be faced with in the interface. Concepts can be broken 
into sub-concepts, creating a hierarchical tree of concepts. This tree can be arbitrarily deep and wide to support rich concept 
modeling. Concepts can also own an arbitrary number of Coach Topics. Coach Topics are objects that represent a discussion 
topic that may be appropriate for a concept. Coach Topics can own an arbitrary number of Coach Items. Coach Items are items 
of feedback that may include text, audio, video, URL's, or updates to the Domain Model. Coach Items are owned by Coach 
Topics and are assembled by the Remediation Component algorithm. 

Workbenches- The BusSim Toolset also includes a set of workbenches that are used by instructional designers to 
design and build BusSim applications. A workbench is a tool that facilitates visual editing or testing of the data that the BusSim 
Components use for determining an application's run-time behavior. The BusSim Toolset includes the following workbenches: 
Knowledge Workbench - The Knowledge Workbench is a tool for the creation of domain, analysis and feedback data that is 
used by the BusSim Components. It has the following features: Allows the designer to 'paint' knowledge in a drag-and-drop 
interface; Knowledge is represented visually for easy communication among designers; The interface is intelligent, allowing 
designers to only paint valid interactions; Designer's Task creations are stored in a central repository; The workbench supports 
check-in / check-out for exclusive editing of a task; Supports LAN-based or untethered editing; Automatically generates 
documentation of the designs; and it Generates the data files that drive the behavior of the components. Simulated Student 
Test Workbench- The Simulated Student Test Workbench is a tool for the creation of data that simulates student's actions for 
testing BusSim Component behaviors. It has the following features: The Test Bench generates a simulated application interface 
based on the Domain Model; The designer manipulates the objects in the Domain Model to simulate student activity; The 
designer can invoke the components to experience the interactions the student will experience in production; and The designer 
can fully test the interaction behavior prior to development of the application interface. Regression Test Workbench - The 
Regression Test Workbench is a tool for replaying and testing of student sessions to aid debugging. It has the following features: 
Each student submission can be individually replayed through the components; An arbitrary number of student submissions from 
the same session can be replayed in succession; Entire student sessions can be replayed in batch instantly; The interaction 
results of the student are juxtaposed with the results of the regression test for comparison. 

Development Cycle Activities 

The design phase of a BusSim application is streamlined by the use of the Knowledge Workbench. The Knowledge 
Workbench is a visual editor for configuring the objects of the component engines to control their runtime behavior. The 
components are based on proven algorithms that capture and implement best practices and provide a conceptual framework and 
methodology for instructional design. In conceptual design, the workbench allows the designer to paint a model of the hierarchy 
of Concepts that the student will need to master in the activity. This helps the designer organize the content in a logical way. The 
visual representation of the Concepts helps to communicate ideas to other designers for review. The consistent look and feel of 
the workbench also contributes to a streamlined Quality Assurance process. In addition, standard documentation can be 
automatically generated for the entire design. As the design phase progresses, the designer adds more detail to the design of the 
Concept hierarchy by painting in Coach Topics that the student may need feedback on. The designer can associate multiple 
feedback topics with each Concept. The designer also characterizes each topic as being Praise, Polish, Focus, Redirect or one 
of several other types of feedback that are consistent with a proven remediation methodology. The designer can then fill each 
topic with text, video war stories, Web page links, Authorware links, or any other media object that can be delivered to the 
student as part of the feedback topic. 
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The toolset greatly reduces effort during functionality testing. The key driver of the effort reduction is that the 
components can automatically track the actions of the tester without the need to add code support in the application. Whenever 
the tester takes an action in the interface, it is reported to the domain model. From there it can be tracked in a database. Testers 
no longer need to write down their actions for use in debugging; they are automatically written to disk. There is also a feature for 
attaching comments to a tester's actions. When unexpected behavior is encountered, the tester can hit a control key sequence 
that pops up a dialog to record a description of the errant behavior. During the Execution Phase, the components are deployed to 
the student's platform. They provide simulated team member and feedback functionality with sub-second response time and 
error-free operation. If the client desires it, student tracking mechanisms can be deployed at runtime for evaluation and 
administration of students. This also enables the isolation of any defects that may have made it to production. 

Scenarios for Using the Business Simulation Toolset 

A good way to gain a better appreciation for how the BusSim Toolset can vastly improve the BusSim development 
effort is to walk through scenarios of how the tools would be used throughout the development lifecycie of a particular task in a 
BusSim application. For this purpose, we'll assume that the goal of the student in a specific task is to journalize invoice 
transactions, and that this task is within the broader context of learning the fundamentals of financial accounting. A cursory 
description of the task from the student's perspective will help set the context for the scenarios. Following the description are five 
scenarios which describe various activities in the development of this task. The figure below shows a screen shot of the task 
interface. Figure 7 illustrates the use of a toolbar to navigate and access application level features in accordance with a 
preferred embodiment. A student uses a toolbar to navigate and also to access some of the application-level features of the 
application. The toolbar is the inverted L-shaped object across the top and left of the interface. The top section of the toolbar 
allows the user to navigate to tasks within the current activity. The left section of the toolbar allows the student to access other 
features of the application, including feedback. The student can have his deliverables analyzed and receive feedback by clicking 
on the Team button. 

In this task, the student must journalize twenty-two invoices and other source documents to record the flow of budget 
dollars between internal accounts. (Note: "Journalizing", or "Journalization", is the process of recording journal entries in a 
general ledger from invoices or other source documents during an accounting period. The process entails creating debit and 
balancing credit entries for each document. At the completion of this process, the general ledger records are used to create a 
trial balance and subsequent financial reports.) In accordance with a preferred embodiment, an Intelligent Coaching Agent Tool 
(ICAT) was developed to standardize and simplify the creation and delivery of feedback in a highly complex and open-ended 
environment. Feedback from a coach or tutor is instrumental in guiding the learner through an application. Moreover, by 
diagnosing trouble areas and recommending specific actions based on predicted student understanding of the domain student 
comprehension of key concepts is increased. By writing rules and feedback that correspond to a proven feedback strategy, 
consistent feedback is delivered throughout the application, regardless of the interaction type or of the specific 
designer/developer creating the feedback. The ICAT is packaged with a user-friendly workbench, so that it may be reused to 
increase productivity on projects requiring a similar rule-based data engine and repository. 

Definition of ICAT In Accordance with a Preferred Embodiment 

The Intelligent Coaching Agent Tool (ICAT) is a suite of tools-a database and a Dynamic Link Library (DLL) run-time 
engine — used by designers to create and execute just-in-time feedback of Goal Based training. Designers write feedback and 
rules in the development tools. Once the feedback is set, the run-time engine monitors user actions, fires rules and composes 
feedback which describes the business deliverable. The remediation model used within ICAT dynamically composes the most 
appropriate feedback to deliver to a student based on student's previous responses. The ICAT model is based on a theory of 
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feedback which has been proven effective by pilot results and informal interviews. The model is embodied in the object model 
and algorithms of the ICAT. Because the model is built into the tools, all feedback created with the tool will conform to the model. 
ICAT plays two roles in student training. First, the ICAT is a teaching system, helping students to fully comprehend and apply 
information. Second, ICAT is a gatekeeper, ensuring that each student has mastered the material before moving on to additional 
5 information. ICAT is a self contained module, separate from the application. Separating the ICAT from the application allows 

other projects to use the ICAT and allows designers to test feedback before the application is complete. The ICAT Module is built 
on six processes which allow a student to interact effectively with the interface to compose and deliver the appropriate feedback 
for a student's mistakes. ICAT development methodology is a seven step methodology for creating feedback. The methodology 
contains specific steps, general guidelines and lessons learned from the field. Using the methodology increases the effectiveness 
10 of the feedback to meet the educational requirements of the course. The processes each contain a knowledge model and some 
contain algorithms. Each process has specific knowledge architected into its design to enhance remediation and teaching. There 
is a suite of testing tools for the ICAT. These tools allow designers and developers test all of their feedback and rules. In addition, 
the utilities let designers capture real time activities of students as they go through the course. The tools and run-time engine in 
accordance with a preferred embodiment include expert knowledge of remediation. These objects include logic that analyzes a 
15 student's work to identify problem areas and deliver focused feedback, The designers need only instantiate the objects to put the 
tools to work. Embodying expert knowledge in the tools and engine ensures that each section of a course has the same effective 
feedback structure in place. A file structure in accordance with a preferred embodiment provides a standard system environment 
for all applications in accordance with a preferred embodiment. A development directory holds a plurality of sub-directories. The 
content in the documentation directory is part of a separate installation from the architecture. This is due to the size of the 
fn 20 documentation directory. It does not require any support files, thus it may be placed on a LAN or on individual computers. When 
ttl the architecture is installed in accordance with a preferred embodiment, the development directory has an _Arch, JTools, 

JL .Utilities, Documentation, QED, and XDefault development directory. Each folder has its own directory structure that is inter- 

f?| linked with the other directories. This structure must be maintained to assure consistency and compatibility between projects to 

clarify project differences, and architecture updates. 
1 25 The _Arch directory stores many of the most common parts of the system architecture. These files generally do not 

change and can be reused in any area of the project. If there is common visual basic code for applications that will continuously 
be used in other applications, the files will be housed in a folder in this directory. The sub-directories in the _Arch directory are 
broken into certain objects of the main project. Object in this case refers to parts of a project that are commonly referred to within 
the project. For example, modules and classes are defined here, and the directory is analogous to a library of functions, APIs, 
30 etc... that do not change. For example the IcaObj directory stores code for the Intelligent Coaching Agent (ICA). The InBoxObj 
directory stores code for the InBox part of the project and so on. The file structure uses some primary object references as file 
directories. For example, the IcaObj directory is a component that contains primary objects for the ICA such as functional forms, 
modules and classes. The BrowserObj directory contains modules, classes and forms related to the browser functionality in the 
architecture. The HTMLGIossary directory contains code that is used for the HTML reference and glossary component of the 
35 architecture. The IcaObj directory contains ICA functional code to be used in an application. This code is instantiated and 
enhanced in accordance with a preferred embodiment The InBoxObj directory contains code pertaining to the inbox 
functionality used within the architecture. Specifically, there are two major components in this architecture directory. There is a 
new .ocx control that was created to provide functionality for an inbox in the application. There is also code that provides support 
for a legacy inbox application, The PracticeObj directory contains code for the topics component of the architecture. The topics 
40 component can be implemented with the HTMLGIossary component as well. The QmediaObj directory contains the components 
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that are media related. An example is the QVIDctrt.cls. The QVIDctrl is the code that creates the links between QVID files in an 
application and the system in accordance with a preferred embodiment. The SimObj directory contains the Simulation Engine, a 
component of the application that notifies the tutor of inputs and outputs using a spreadsheet to facilitate communication. The 
StaticObj directory holds any component that the application will use statically from the rest of the application. For example, the 

5 login form is kept in this folder and is used as a static object in accordance with a preferred embodiment. The SysDynObj 

directory contains the code that allows the Systems Dynamics Engine (Powersim) to pass values to the Simulation Engine and 
return the values to the tutor. The VBObj directory contains common Visual Basic objects used in applications. For example the 
NowWhat, Visual Basic Reference forms, and specific message box components are stored in this folder. The .Tools directory 
contains two main directories. They represent the two most used tools in accordance with a preferred embodiment. The two 

10 directories provide the code for the tools themselves. The reason for providing the code for these tools is to allow a developer to 
enhance certain parts of the tools to extend their ability. This is important for the current project development and also for the 
growth of the tools. The Icautils directory contains a data, database, default, graphics, icadoc, and testdata directory. The 
purpose of all of these directories is to provide a secondary working directory for a developer to keep their testing environment of 
enhanced Icautils applications separate from the project application. It is built as a testbed for the tool only. No application 

15 specific work should be done here. The purpose of each of these directories will be explained in more depth in the project 

4? directory section. The TestData folder is unique to the Jools/ICAUtils directory. It contains test data for the regression bench 

ff- among others components in ICAUtils. 

51 The Utilities directory holds the available utilities that a Business Simulation project requires for optimal results. This is 

a repository for code and executable utilities that developers and designers may utilize and enhance in accordance with a 
$h preferred embodiment. Most of the utilities are small applications or tools that can be used in the production of simulations which 
ft] comprise an executable and code to go with it for any enhancements or changes to the utility. If new utilities are created on a 
^ project or existing utilities are enhanced, it is important to notify the managers or developers in charge of keeping track of the 
fl* Business Simulation assets. Any enhancements, changes or additions to the Business Simulation technology assets are 
Ty important for future and existing projects. 

s 

In the ICAT model of feedback, there are four levels of severity of error and four corresponding levels of feedback. The 
tutor goes through the student's work, identifies the severity of the error and then provides the corresponding level of feedback. 


Educational Categories of Feedback 

ERROR 

FEEDBACK 

Error 

Type 

Descripti 

on 

Feedbac 

kType 

Description 

None 

No errors 
exist. The student's 
work is perfect. 

Praise 

Confirmation that the student 
completed the task correctly. 
ExampIe:Great. You have journalized 
all accounts correctly. 1 am happy to 
see you recognized we are paying for 
most of our bills tt on account". 

Syntacti 

There may be 

Polish 

Tells the student the 
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spelling mistakes or 


specific actions he did incorrectly, 


other syntactic 


and possibly correct them for him. 


errors. As a 




designer, you 


Example: 


should be confident 


There are one or two errors 


that the student will 


in your work. It looks like you 


have mastered the 


misclassified the purchase of the fax 


material at this 


as a cash purchase when it is really a 


point. 


purchase on account. 

Local 

A 

Focus 

Focus the student on this 


paragraph of a 


area of his work. Point out that he 


paper is missing or 


does not understand at least one 


the student has 


major concept. 


made a number of 




mistakes all in one 


Example: 


area. The student 


Looking over your work, I 


clearly does not 


see that you do not understand the 


understand this 


concept of "on account". Why don't 


area. 


you review that concept and review 




* your work for errors. 

Global 

The 

Redirect 

Restate the goal of the 


student has written 


activity and tell the student to review 


on the wrong 


main concepts and retry the activity. 


subject or there are 


"There are lots of mistakes 


mistakes all over the 


throughout your work. You need to 


student's work 


think about what type of transaction 




each source document represents 




before journalizing it." 


Returning to the analogy of helping someone write a paper, if the student writes on the wrong subject, this as a global 
error requiring redirect feedback. If the student returns with the paper rewritten, but with many errors in one area of the paper, 
focus feedback is needed. With all of those errors fixed and only spelling mistakes-syntactic mistakes-polish feedback is 
needed. When all syntactic mistakes were corrected, the tutor would return praise and restate why the student had written the 
correct paper, Focusing on the educational components of completing a task is not enough. As any teacher knows, student will 
often try and cheat their way through a task. Students may do no work and hope the teacher does not notice or the student may 
only do minor changes in hope of a hint or part of the answer. To accommodate these administrative functions, there are three 
additional administrative categories of feedback. The administrative and the educational categories of feedback account for every 
piece of feedback a designer can write and a student can receive. To provide a better understanding of how the feedback works 
together, an example is provided below. 


' Figure 8 is a GBS display in accordance with a preferred embodiment. The upper right area of the screen shows the 
account list. There are four types of accounts: Assets, Liabilities & Equity, Revenues, and Expenses. The user clicks on one of 
the tabs to show the accounts of the corresponding type. The student journalizes a transaction by dragging an account from the 
account list onto the journal entry Debits or Credits. The student then enters the dollar amounts to debit or credit each account in 
the entry. In the interface, as in real life, the student can have multi-legged journal entries (i.e., debiting or crediting multiple 
accounts). A Toolbar 1200 and the first transaction of this Task 1210 appear prominently on the display. The student can move 
forward and back through the stack of transactions. For each transaction, the student must identify which accounts to debit and 
which to credit. When the student is done, he clicks the Team button. Figure 9 is a feedback display in accordance with a 
preferred embodiment. The student may attempt to outsmart the system by submitting without doing anything. The ICAT system 
identifies that the student has not done a substantial amount of work and returns the administrative feedback depicted in Figure 
9. The feedback points out that nothing has been done, but it also states that if the student does some work, the tutor will focus 
on the first few journal entries. Figure 10 illustrates a journal entry simulation in accordance with a preferred embodiment. Figure 
1 1 illustrates a simulated Bell Phone Bill journal entry in accordance with a preferred embodiment. The journal entry is 
accomplished by debiting Utilities Expenses and Crediting Cash for $700 each. Figure 12 illustrates a feedback display in 
accordance with a preferred embodiment. After attempting to journalize the first three transactions, the student submits his work 
and receives the feedback depicted in Figure 12. The feedback starts by focusing the student on the area of work being 
evaluated. The ICAT states that it is only looking at the first three journal entries. The feedback states that the first two entries are 
completely wrong, but the third is close. If the student had made large mistakes on each of the first three transactions, then the 
ICAT may have given redirect feedback, thinking a global error occurred. The third bullet point also highlights how specific the 
feedback can become, identifying near misses. 

Design Scenario-This Scenario illustrates how the tools are used to support conceptual and detailed design of a 
BusSim application. Figure 13 illustrates the steps of the first scenario in accordance with a preferred embodiment The designer 
has gathered requirements and determined that to support the client's learning objectives, a task is required that teaches 
journalization skills. The designer begins the design first by learning about journalization herself, and then by using the 
Knowledge Workbench to sketch a hierarchy of the concepts she want the student to learn. At the most general level, she 
creates a root concept of 'Journalization'. She refines this by defining sub-concepts of 'Cash related transactions', 'Expense 
related Transactions', and 'Expense on account transactions'. These are each further refined to whatever level of depth is 
required to support the quality of the learning and the fidelity of the simulation, The designer then designs the journalization 
interface. Since a great way to learn is by doing, she decides that the student should be asked to Journalize a set of transactions. 
She comes up with a set of twenty-two documents that typify those a finance professional might see on the job. They include the 
gamut of Asset, Expense, Liability and Equity, and Revenue transactions. Also included are some documents that are not 
supposed to be entered in the journal. These 'Distracters' are included because sometimes errant documents occur in real life. 
The designer then uses the Domain Model features in the Knowledge Workbench to paint a Journal. An entity is created in the 
Domain Model to represent each transaction and each source document. Based on the twenty-two documents that the designer 
chose, she can anticipate errors that the student might make. For these errors, she creates topics of feedback and populates 
them with text. She also creates topics of feedback to tell the student when they have succeeded. Feedback Topics are created 
to handle a variety of situations that the student may cause. 

The next step is to create profiles that the will trigger the topics in the concept tree (this task is not computational in 
nature, so the Transformation Component does not need to be configured) . A profile resolves to true when its conditions are met 
by the student's work. Each profile that resolves to true triggers a topic. To do some preliminary testing on the design, the 
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designer invokes the Student Simulator Test Workbench. The designer can manipulate the Domain Model as if she were the 
student working in the interface. She drags accounts around to different transactions, indicating how she would like them 
journalized. She also enters the dollar amounts that she would like to debit or credit each account. She submits her actions to the 
component engines to see the feedback the student would get if he had performed the activity in the same way. All of this occurs 
5 in the test bench without an application interface. The last step in this phase is low-fi user testing. A test student interacts with a 
PowerPoint slide or bitmap of the proposed application interface for the Journalization Task. A facilitator mimics his actions in the 
test bench and tells him what the feedback would be. This simplifies low-fi user testing and helps the designer to identify usability 
issues earlier in the design when they are much cheaper to resolve. 

Figures 14 and 15 illustrate the steps associated with a build scenario in accordance with a preferred embodiment. 
10 The instructional designer completes the initial interaction and interface designs as seen in the previous Scenario. After low-fi 

user testing, the Build Phase begins. Graphic artists use the designs to create the bitmaps that will make up the interface. These 
include bitmaps for the buttons, tabs, and transactions, as well as all the other screen widgets. The developer builds the interface 
using the bitmaps and adds the functionality that notifies the Domain Model of student actions. Standard event-driven 
programming techniques are used to create code that will react to events in the interface during application execution and pass 
15 the appropriate information to the Domain Model. The developer does not need to have any deep knowledge about the content 
~S because she does not have to build any logic to support analysis of the student actions or feedback. The developer also codes 

m the logic to rebuild the interface based on changes to the domain model. A few passes through these steps will typically be 

Si required to get the application communicating correctly with the components. The debug utilities and Regression Test 

il Workbench streamline the process. After the application interface and component communication are functioning as designed, 

fy 20 the task is migrated to Usability testing. 

W The Test Scenario demonstrates the cycle that the team goes through to test the application. It specifically addresses 

]L usability testing, but it is easy to see how the tools also benefit functional and cognition testing. Again, we will use the 

fp Journalization Task as an example. Figure 16 illustrates a test scenario in accordance with a preferred embodiment. The test 

[V students work through the journalization activity. One of the students has made it over half way through the task and has just 

li 25 attempted to journalize the sixteenth transaction. The student submits to the Financial Coach, but the feedback comes back 
M* blank. The student notifies the facilitator who right-clicks on the Financial Coach's face in the feedback window. A dialog pops up 

that shows this is the twenty-seventh submission and shows some other details about the submission. The facilitator (or even the 
student in recent efforts) enters a text description of the problem, and fills out some other fields to indicate the nature and 
severity of the problem. All the student's work and the feedback they got for the twenty-seven submissions is posted to the User 
30 Acceptance Test (UAT) archive database. The instructional designer can review alt the student histories in the UAT database 
and retrieve the session where the student in question attempted the Journalization Task. The designer then recreates the 
problem by replaying the student's twenty-seven submissions through the component engines using the Regression Test 
Workbench. The designer can then browse through each submission that the student made and view the work that the student 
did on the submission, the feedback the student got, and the facilitator comments, if any. Now the designer can use the 
35 debugging tools to determine the source of the problem. In a few minutes, she is able to determine that additional profiles and 
topics are needed to address the specific combinations of mistakes the student made. She uses the Knowledge Workbench to 
design the new profiles and topics. She also adds a placeholder and a script for a video war story that supports the learning 
under these circumstances. The designer saves the new design of the task and reruns the Regression Test Workbench on the 
student's session with the new task design. After she is satisfied that the new profiles, topics, and war stories are giving the 
40 desired coverage, she ships the new task design file to user testing and it's rolled out to all of the users. 
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Execution Scenario: Student Administration - Figure 17 illustrates how the tool suite supports student 
administration in accordance with a preferred embodiment. When a student first enters a course she performs a pre-test of his 
financial skills and fills out an information sheet about his job role, level, etc. This information is reported to the Domain Model. 
The Profiling Component analyzes the pre-test, information sheet, and any other data to determine the specific learning needs of 
this student. A curriculum is dynamically configured from the Task Library for this student. The application configures its main 
navigational interface (if the app has one) to indicate that this student needs to learn Journalization, among other things. As the 
student progresses through the course, his performance indicates that his proficiency is growing more rapidly in some areas than 
in others. Based on this finding, his curriculum is altered to give him additional Tasks that will help him master the content he is 
having trouble with. Also, Tasks may be removed where he has demonstrated proficiency. While the student is performing the 
work in the Tasks, every action he takes, the feedback he gets, and any other indicators of performance are tracked in the 
Student Tracking Database. Periodically, part or all of the tracked data are transmitted to a central location. The data can be 
used to verify that the student completed all of the work, and it can be further analyzed to measure his degree of mastery of the 
content. 

Execution Scenario: Student Interaction • Figure 18 illustrates a suite to support a student interaction in accordance 
with a preferred embodiment. In this task the student is trying to journalize invoices. He sees a chart of accounts, an invoice, and 
the journal entry for each invoice. He journalizes a transaction by dragging and dropping an account from the chart of accounts 
onto the 'Debits' or the 'Credits' line of the journal entry and entering the dollar amount of the debit or credit. He does this for 
each transaction. As the student interacts with the interface, all actions are reported to and recorded in the Domain Model. The 
Domain Model has a meta-model describing a transaction, its data, and what information a journal entry contains. The actions of 
the student populates the entities in the domain model with the appropriate information. When the student is ready, he submits 
the work to a simulated team member for review. This submission triggers the Analysis-Interpretation cycle. The Transformation 
Component is invoked and performs additional calculations on the data in the Domain Model, perhaps determining that Debits 
and Credits are unbalanced for a given journal entry. The Profiling Component can then perform rule-based pattern matching on 
the Domain Model, examining both the student actions and results of any Transformation Component analysis. Some of the 
profiles fire as they identify the mistakes and correct answers the student has given. Any profiles that fire activate topics in the 
Remediation Component. After the Profiling Component completes, the Remediation Component is invoked. The remediation 
algorithm searches the active topics in the tree of concepts to determine the best set of topics to deliver. This set may contain 
text, video, audio, URLs, even actions that manipulate the Domain Model. It is then assembled into prose-like paragraphs of text 
and media and presented to the student. The text feedback helps the student localize his journalization errors and understand 
why they are wrong and what is needed to correct the mistakes. The student is presented with the opportunity to view a video 
war story about the tax and legal consequences that arise from incorrect journalization. He is also presented with links to the 
reference materials that describe the fundamentals of journalization. The Analysis-Interpretation cycle ends when any coach 
items that result in updates to the Domain Model have been posted and the interface is redrawn to represent the new domain 
data. In this case, the designer chose to highlight with a red check the transactions that the student journalized incorrectly. 

The Functional Definition of the ICAT 

This section describes the feedback processes in accordance with a preferred embodiment. For each process, there is 
a definition of the process and a high-level description of the knowledge model. This definition is intended to give the reader a 
baseline understanding of some of the key components/objects in the model, so that he can proceed with the remaining sections 
of this paper. Refer to the Detailed Components of the ICAT for a more detailed description of each of the components within 
each knowledge model. To gain a general understanding of the ICAT, read only the general descriptions. To understand the 
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ICAT deeply, read this section and the detailed component section regarding knowledge models and algorithms. These 
processes and algorithms embody the feedback model in the ICAT. There are six main processes in the ICAT, described below 
and in more detail on the following pages. 

Figure 19 illustrates the remediation process in accordance with a preferred embodiment. Remediation starts as 
students interact with the application's interface (process #1). As the student tries to complete the business deliverable, the 
application sends messages to the ICAT about each action taken (process #2). When the student is done and submits work for 
review, the ICAT compares how the student completed the activity with how the designer stated the activity should be completed 
(this is called domain knowledge). From this comparison, the ICAT get a count of how many items are right, wrong or irrelevant 
(process #3). With the count complete, the ICAT tries to fire all rules (process #4). Any rules which fire activate a coach topic 
(process #5). The feedback algorithm selects pieces of feedback to show and composes them into coherent paragraphs of text 
(process #6). Finally, as part of creating feedback text paragraphs, the ICAT replaces all variables in the feedback with specifics 
from the student's work. This gives the feedback even more specificity, so that it is truly customized to each student's actions. 

Knowledge Model - Interface Objects In any GBS Task, the student must manipulate controls on the application 
interface to complete the required deliverables. Figure 20 illustrates the objects for the journalization task in accordance with a 
preferred embodiment. The following abstract objects are used to model all the various types of interface interactions. A 
Sourceltem is an object the student uses to complete a task. In the journalization example, the student makes a debit and credit 
for each transaction. The student has a finite set of accounts with which to respond for each transaction. Each account that 
appears in the interface has a corresponding Sourceltem object. In other words, the items the student can manipulate to 
complete the task (account names) are called Sourceltems. A Source is an object that groups a set of Sourceltem objects 
together. Source objects have a One-To-Many relationship with Sourceltem objects. In the journalization example, there are four 
types of accounts: Assets, Liabilities and Equity, Revenues, and Expenses. Each Account is of one and only one of these types 
and thus appears only under the appropriate tab. For each of the Account type tabs, there is a corresponding Source Object. A 
Target is a fixed place where students place Sourceltems to complete a task. In the journalization example, the student places 
accounts on two possible targets: debits and credits. The top two lines of the journal entry control are Debit targets and the 
bottom two lines are Credit targets. These two targets are specific to the twelfth transaction. A TargetPage is an object that 
groups a set of Target objects together. TargetPage objects have a One-To-Many relationship with Target objects (just like the 
Source to Sourceltem relationship). In the journalization example, there is one journal entry for each of the twenty-two 
transactions. For each journal entry there is a corresponding TargetPage object that contains the Debits Target and Credits 
Target for that journal entry. 

As the student manipulates the application interface, each action is reported to the ICAT. In order to tell the ICAT what 
actions were taken, the application calls to a database and asks for a specific interface control's ID. When the application has the 
ID of the target control and the Sourceltem control, the application notifies the ICAT about the Target to Sourceltem mapping. In 
other words, every time a student manipulates a source item and associates it with a target (e.g., dragging an account name to a 
debit line in the journal), the user action is recorded as a mapping of the source item to the target. This mapping is called a 
UserSourceltemTarget. Figure 21 illustrates the mapping of a source item to a target item in accordance with a preferred 
embodiment. When the student is ready, he submits his work to one of the simulated team members by clicking on the team 
member's icon. When the ICAT receives the student's work, it calculates how much of the work is correct by concept. Concepts 
in our journalization activity will include Debits, Credits, Asset Accounts, etc. For each of these concepts, the ICAT will review all 
student actions and determine how many of the student actions were correct. In order for the ICAT to understand which targets 
on the interface are associated with each concept, the targets are bundled into target groups and prioritized in a hierarchy. Once 
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all possible coach topics are activated, a feedback selection analyzes the active pieces of remediation within the concept 
hierarchy and selects the most appropriate for delivery. The selected pieces of feedback are then assembled into a cohesive 
paragraph of feedback and delivered to the student. Figure 23 illustrates a feedback selection in accordance with a preferred 
embodiment. After the ICAT has activated CoachTopics via Rule firings, the Feedback Selection Algorithm is used to determine 
the most appropriate set of Coachltems (specific pieces of feedback text associated with a CoachTopic) to deliver. The Algorithm 
accomplishes this by analyzing the concept hierarchy (TargetGroup tree), the active CoachTopics, and the usage history of the 
Coachltems. Figure 24 is a flowchart of the feedback logic in accordance with a preferred embodiment. There are five main 
areas to the feedback logic which execute sequentially as listed below. First, the algorithm looks through the target groups and 
looks for the top-most target group with an active coach topic in it. Second, the algorithm then looks to see if that top-most coach 
item is praise feedback. If it is praise feedback, then the student has correctly completed the business deliverable and the ICAT 
will stop and return that coach item. Third, if the feedback is not Praise, then the ICAT will look to see if it is redirect, polish, 
mastermind or incomplete-stop. If it is any of these, then the algorithm will stop and return that feedback to the user. Fourth, if the 
feedback is focus, then the algorithm looks to the children target groups and groups any active feedback in these target groups 
with the focus group header. Fifth, once the feedback has been gathered, then the substitution language is run which replaces 
substitution variables with the proper names. Once the ICAT has chosen the pieces of feedback to return, the feedback pieces 
are assembled into a paragraph. With the paragraph assembled, the ICAT goes through and replaces all variables. There are 
specific variables for Sourceltems and Targets. Variables give feedback specificity. The feedback can point out which wrong 
Sourceltems were placed on which Targets. It also provides hints by providing one or two Sourceltems which are mapped to the 
Target. 

The Steps Involved in Creating Feedback in AccordanceWith A Preferred Embodiment 

The goal of feedback is to help a student complete a business deliverable. The tutor needs to identify which concepts 
the student understands and which he does not. The tutor needs to tell the student about his problems and help him understand 
the concepts. There are seven major steps involved in developing feedback for an application. First, creating a strategy — The 
designer defines what the student should know. Second, limit errors through interface — The designer determines if the interface 
will identify some low level mistakes. Third, creating a target group hierarchy — The designer represents that knowledge in the 
tutor. Fourth, sequencing the target group hierarchy — The designer tells the tutor which concepts should be diagnosed first. 
Fifth, writing feedback — The designer writes feedback which tells the student how he did and what to do next. Sixth, writing 
Levels of Feedback — The designer writes different levels of feedback in case the student makes the same mistake more than 
once. Seventh, writing rules — The designer defines patterns which fire the feedback. 

A feedback strategy is a loose set of questions which guide the designer as he creates rules and feedback, The 
strategy describes what the student should learn, how he will try and create the business deliverable and how an expert 
completes the deliverable. The goal of the application should be for the student to transition from the novice model to the expert 
model. What should the student know after using the application? The first task a designer needs to complete is to define 
exactly what knowledge a student must learn by the end of the interaction. Should the student know specific pieces of 
knowledge, such as formulas? Or, should the student understand high level strategies and detailed business processes? This 
knowledge is the foundation of the feedback strategy. The tutor needs to identify if the student has used the knowledge correctly, 
or if there were mistakes. An example is the journal task. For this activity, students need to know the purpose of the journalizing 
activity, the specific accounts to debit/credit, and how much to debit/credit. A student's debit/credit is not correct or incorrect in 
isolation, but correct and incorrect in connection with the dollars debited/credited. Because there are two different types of 


knowledge-accounts to debit/credit and amounts to debit/credit— the feedback needs to identify and provide appropriate 
feedback for both types of mistakes. 

How will a novice try and complete the task? Designers should start by defining how they believe a novice will try and 
complete the task. Which areas are hard and which are easy for the student. This novice view is the mental model a student will 
bring to the task and the feedback should help the student move to an expert view. Designers should pay special attention to 
characteristic mistakes they believe the student will make. Designers will want to create specific feedback for these mistakes. An 
example is mixing up expense accounts in the journal activity. Because students may mix up some of these accounts, the 
designer may need to write special feedback to help clear up any confusion. 

How does an expert complete the task? This is the expert model of completing the task. The feedback should help 
students transition to this understanding of the domain. When creating feedback, a designer should incorporate key features of 
the expert model into the praise feedback he writes. When a student completes portion of the task, positive reinforcement should 
be provided which confirms to the student that he is doing the task correctly and can use the same process to complete the other 
tasks. These four questions are not an outline for creating feedback, but they define what the feedback and the whole 
application needs to accomplish. The designer should make sure that the feedback evaluates all of the knowledge a student 
should learn. In addition, the feedback should be able to remediate any characteristic mistakes the designer feels the student will 
make. Finally, the designer should group feedback so that it returns feedback as if it were an expert. With these components 
identified, a designer is ready to start creating target group hierarchies. Because there are positive and negative repercussions, 
designers need to select the when to remediate through the interface carefully. The criteria for making the decision is if the 
mistake is a low level data entry mistake or a high level intellectual mistake. If the mistake is a low level mistake, such as miss- 
typing data, it may be appropriate to remediate via the interface. If the designer decides to have the interface point out the 
mistakes, it should look as if the system generated the message. System generated messages are mechanical checks, requiring 
no complex reasoning. In contrast, complex reasoning, such as why a student chose a certain type of account to credit or debit 
should be remediated through the ICAT. 

System messages - It is very important that the student know what type of remediation he is going to get from each 
source of information. Interface based remediation should look and feel like system messages. They should use a different 
interface from the ICAT remediation and should have a different feel. In the journalization task described throughout this paper, 
there is a system message which states "Credits do not equal debits." This message is delivered through a different interface 
and the blunt short sentence is unlike all other remediation. The motivation for this is that low level data entry mistakes do not 
show misunderstanding but instead sloppy work. Sloppy-work mistakes do not require a great deal of reasoning about why they 
occurred instead, they simply need to be identified. High-level reasoning mistakes, however, do require a great deal of reasoning 
about why they occurred, and the ICAT provides tools, such as target groups, to help with complex reasoning. Target group 
hierarchies allow designers to group mistakes and concepts together and ensure that they are remediated at the most 
appropriate time (i.e., Hard concepts will be remediated before easy concepts). Timing and other types of human-like 
remediation require the ICAT; other low-level mistakes which do not require much reasoning include: Incomplete- If the task 
requires a number of inputs, the interface can check that they have all been entered before allowing the student to proceed. By 
catching empty fields early in the process, the student may be saved the frustration of having to look through each entry to try 
and find the empty one. Empty- A simple check for the system is to look and see if anything has been selected or entered. If 
nothing has been selected, it may be appropriate for the system to generate a message stating "You must complete X before 
proceeding". Numbers not matching- Another quick check is matching numbers. As in the journalization activity, is often useful 
to put a quick interface check in place to make sure numbers which must match do. Small data entry mistakes are often better 
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remediated at the interface level than at the tutor or coach level (when they are not criical to the learning objectives of the 
course). There are two main issues which must be remembered when using the interface to remediate errors. First, make sure 
the interface is remediating low level data entry errors. Second, make sure the feedback looks and feels different from the ICAT 
feedback. The interface feedback should look and feel like it is generated from the system while the ICAT feedback must look as 
if it were generated from an intelligent coach who is watching over the student as he works. 

Creating the Target Group Hierarchy- Target groups are sets of targets which are evaluated as one. Returning to the 
severity principle of the feedback theory, it is clear that the tutor needs to identify how much of the activity the student does not 
understand. Is it a global problem and the student does not understand anything about the activity? Or, is it a local problem and 
the student simply is confused over one concept? Using the feedback algorithm described earlier, the tutor will return the highest 
target group in which there is feedback. This algorithm requires that the designer start with large target groups and make sub- 
groups which are children of the larger groups. The ICAT allows students to group targets in more than one category. Therefore 
a debit target for transaction thirteen can be in a target group for transaction thirteen entries as well as a target group about 
debits and a target group which includes all source documents. Target should be grouped with four key ideas in mind. Target 
groups are grouped according to: Concepts taught; Interface constraints; Avoidance of information overload and Positive 
reinforcement 

The most important issue when creating target groups is to create them along the concepts students need to know to 
achieve the goal. Grouping targets into groups which are analogous to the concepts a student needs to know, allows the tutor to 
review the concepts and see which concepts confuse the student As a first step, a designer should identify in an unstructured 
manner all of the concepts in the domain. This first pass will be a large list which includes concepts at a variety of granularities, 
from small specific concepts to broad general concepts. These concepts are most likely directly related to the learning objectives 
of the course. With ail of the concepts defined, designers need to identify all of the targets which are in each target group. Some 
targets will be in more than one target group. When a target is in more than one target group, it means that there is some type of 
relationship such as a child relationship or a part to whole relationship. The point is not to create a structured list of concepts but 
a comprehensive list. Structuring them into a hierarchy will be the second step of the process. 

* Notes: Loads from Database or Document based on values 

* of m_StorageTypeTask and m_StorageTypeStudent 
* 

7 

extern "C" 
{ 

long _export WINAPI TuResumeStudent(long StudentID, long TaskID, int fromSubmissionSeqID ); // Resumes a 
Student's work for the Task at the specified Submission 
} 

extern "C B 

{ 

long _export WINAPI TuLoadArchivedSubmissions(long StudentID, long TaskID, int fromSubmissionSeqID, int 
toSubmissionSeqID); // Loads Archived Submissions For a Student's work in a Task 


AND1I v .P 

-23- 


extern "C 
{ 

long __export WINAPI TuUseArchivedSubmissions(int n); // Replays n Archived submissions for debugging 

} 

extern "C" 
{ 

long _export WINAPI TuSaveCurrentStudent(); // Saves Current Student's work to DB 

} 

extern "C" 
{ 

long __export WINAPI KillEngine( long ITaskID); // Delete all Dynamic objects before shutdown 

* Function Return 
•Variables: TUT_ERR_OK 

* Notes: 

it*************************************** 
7 

extern "C" 
{ 

long _export WINAPI TuSetTaskDocPathName( LPCSTR fhm ); 

} 

r 

******** * * *t*k **+**+*+**±**+**tt**lrk*+*** 

*Name: TuSetFeedbackFileName 

* Purpose: To set path and name of file to use for holding feedback 

* Input 

* Parameters: LPCSTR fnm 

* Path and name of file to use for holding feedback 

* Output 

* Parameters: none 
* 

* Function Return 

* Variables: TUT_ERR_OK 
* 

* Notes: 


7 

extern "C" 
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{ 

long ^export WINAPI TuSetFeedbackFileName( LPCSTR fnm ); 

} 


* Name: TuSetFeedbackPrevFileName 

* Purpose: To set path and name of file to use for holding previous feedback 

* Input 

* Parameters: LPCSTR fnm 

Path and name of file to use for holding previous feedback 

* Output 

* Parameters: none 
* 

* Function Return 

* Variables: TUT_ERR_OK 

* Notes: 

7 

extern "C" 
{ 

long _export WINAPI TuSetFeedbackPrevFileName( LPCSTR fnm ); 

r 

************** *************************** 

* Name: TuSetLogFileName 

* Purpose: To set path and name of file to use for full logging 

* Input 

* Parameters: LPCSTR fnm 

* Path and name of file to use for full logging 

* Output 

* Parameters: none 
* 

* Function Return 

* Variables: TUT_ERR_OK 

* Notes: 
*** 

*/ 

extern "C" 
{ 

long _export WINAPI TuSetLogFileName( LPCSTR fnm ); 
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10 


} 

r 


"******************************* 


15 


Name: TuSetLogLoadFileName 

Purpose: To set path and name of file to use for load logging 

Input 

Parameters: LPCSTR fnm 

Path and name of file to use for load logging 

Output 

Parameters: none 

Function Return 

Variables: TUTERR.OK 

Notes: 


ffl20 


*/ 

extern "C 


{ 
} 

r 


long _export WINAPI TuSetLogLoadFi!eName( LPGSTR fnm ); 


^25 


30 


35 


40 


Name: TuSetLogStudentFileName 

Purpose: To set path and name of file to use for student logging 

Input 

Parameters: LPCSTR fnm 

Path and name of file to use for student logging 

Output 

Parameters: none 

Function Return 

Variables: TUT_ERR_OK 

Notes: 

7 

extern "C" 
{ 

long _export WINAPI TuSetLogStudentFileName( LPCSTR fnm ); 
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} 


***************************************** 


* Name: 

* Purpose: 

* Input 

* Parameters: 
* 

* Output 

* Parameters: 


TuSetLogSubmissionFileName 

To set path and name of file to use for submission logging 

LPCSTR fnm 
Path and name of file to use for submission logging 

none 


' Function Return 

'Variables: TUT_ERR_OK 


* Notes: 


V 

extern n C 
{ 

long __export WINAPI TuSetLogSubmissionFileName( LPCSTR fnm ); 

} 


* Name: TuSetLogErrFileName 

* Purpose: To set path and name of file to use for error logging 

* Input 

* Parameters: LPCSTR fnm 

* Path and name of file to use for error logging 

* Output 

* Parameters: none 
* 

* Function Return 
•Variables: TUT_ERR_OK 

* Notes: 


♦♦♦♦ ♦ ft ftftft ftftftft^ftftftft ft ft ft ft ft ftft 


*/ 

extern "C" 
{ 
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iong _export WINAPI TuSetLogErrFileName( LPCSTR fnm ); 

} 


10 


15 


Name: 

Purpose: 

Input 

Parameters: 


Output 
Parameters: 


TuSetTrace 

To turn Trace on and off 

int TraceStatus 
TUT_TRACE_ON Turn Trace On 
TUTJRACE.OFF Turn Trace Off 

none 


Function Return 

Variables: Previous Trace Status Value 
TUTJRACEJ5N 
TUT_TRACE_OFF 


TUT_ERRJNVALID_TRACE_STATUS 


Notes: 


fi25 


30 


35 


7 

extern "C" 
{ 

long _export WINAPI TuSetTrace( int TraceStatus ); 

} 

r 


40 


Name: 
Purpose: 


Input 

Parameters: 


TuSetTrack 

To turn Tracking on and off. While tracking is on 
all work the user does and all feedback the user receives 
is kept. While Tracking is off only the most recent work is kept. 


int TrackStatus 
TUT_TRACK_ON Turn Tracking On 
TUT_TRACK_OFF Turn Tracking Off 

Output 

Parameters: none 
Function Return 
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* Variables: Previous Trace Status Value 

TUTTRACK.ON 
TUT_TRACK_OFF 

TUT_ERRJNVALID_TRACK_STATUS 

* Notes: 
*/ 

extern "C" 
{ 

long _export WINAPI TuSetTrack( int TrackStatus ); 

} 

Simulation Engine 

The idea is for the designer to model the task that he wants a student to accomplish using an Excel spreadsheet. Then, 
have an algorithm or engine that reads all the significant cells of the spreadsheet and notifies the Intelligent Coaching Agent with 
the appropriate information (SourceltemlD, TargetlD and Attribute). This way, the spreadsheet acts as a central repository for 
student data, contains most of the calculations required for the task and in conjunction with the engine handles all the 
communication with the ICA. The task is self contained in the spreadsheet, therefore the designers no longer need a graphical 
user interface to functionally test their designs (smart spreadsheet. Once the model and feedback for it are completely tested by 
designers, developers can incorporate the spreadsheet in a graphical user interface, e.g., Visual Basic as a development 
platform. The simulation spreadsheet is usually invisible and populated using functions provided by the engine. It is very 
important that all modifications that the ICA needs to know about go through the engine because only the engine knows how to 
call the iCA. This significantly reduced the skill level required from programmers, and greatly reduced the time required to 
program each task, in addition, the end-product was less prone to bugs, because the tutor management was centralized. If there 
was a tutor problem, we only had to check on section of code. Finally, since the simulation engine loaded the data from a 
spreadsheet, the chance of data inconsistency between the tutor and the application was nil. 

Figure 25 is a block diagram setting forth the architecture of a simulation model in accordance with a preferred 
embodiment. The Simulation Object Model consists of a spreadsheet model, a spreadsheet control object, a simulation engine 
object, a simulation database, input objects, output objects, list objects and path objects. The first object in our discussion is the 
Spreadsheet object. The Spreadsheet is the support for all simulation models. A control object that is readily integrated with the 
Visual Basic development plat. The control supports printing and is compatible with Microsoft Excel spreadsheets. With that in 
mind, designers can use the power of Excel formulas to build the simulation. The different cells contained in the spreadsheet 
model can be configured as Inputs, Outputs or Lists and belong to a simulation Path. All cells in the spreadsheet that need to be 
manually entered by the designer or the student via the GBS application are represented by input objects. Every input has the 
following interface: 


Field Name 

Data 
Type 

Description 

InputID 

long 

Primary Key for the table 

TaskID 

long 

TaskID of the task associated with the input 



PathID 

long 

PathID of the path associated with the input 

InputName 

string*5 
0 

Name of the input 

InputDesc 

string*2 
55 

Description of the input 

ReferenceNam 

e 

string*5 
0 

Name of the spreadsheet cell associated with the input 

TutorAware 

boolean 

Whether the ICA should be notified of any changes to the input 

SourceltemID 

long 

SourceltemID if input is a distinct input; 0 if input is a drag drop 
input 

TargetID 

long 

TargetID of the input 


long 

OUf tJdUollCCl 1UW MUlMUCl Ul UIC It l|JU L x OfJCCU U|JUllU£.aUUII 

Column 

long 

Spreadsheet column number of the input -> speed optimization 

SheetName 

string*5 
0 

Sheet name were the input is located -> speed optimization 


This information is stored for every input in the Input table of the simulation database (ICASim.mdb). Refer to the 
example below. When designers construct their simulation model, they must be aware of the fact that there are 2 types of 
Inputs: Distinct Input & Drag & Drop Input. The Distinct Input consists of a single spreadsheet ceil that can be filled by the 
designer at design time or by the GBS application at run time via the simulation engine object's methods. The purpose of the ceil 
is to provide an entry point to the simulation model. This entry point can be for example an answer to a question or a parameter 
to an equation. If the cell is TutorAware (all inputs are usually TutorAware), the ICA will be notified of any changes to the cell. 
When the ICA is notified of a change two messages are in fact sent to the ICA: An ICANotifyDestroy message with the input 
information i.e., SourceltemID, TargetID and null as Attribute. This message is to advise the ICA to remove this information from 
its memory. An ICANotifyCreate message with the input information i.e., SourceltemID, TargetID, Attribute (cell numeric value) . 
This message is to advise the ICA to add this information to its memory. A Distinct Input never requires that a user answer a 
mathematics question. 

These are the steps required to configure that simulation: Define a name for cell C2 in Excel. Here we have defined 
"Distinctjnput". In the ICA, define a task that will be assigned to the simulation. Ex: a TaskID of 123 is generated by the ICA. in 
the ICA, define a Target for the input. Ex: a TargetID of 4001 is generated by the ICA. In the ICA, define a Sourceltem for the 
input. Ex: a SourceltemID of 1201 is generated by the ICA. Associate the input to a path (refer to Path object discussion). Add 
the information in the Input table of the simulation engine database. A record in an Input table is presented below. 


InputID: 

12345 

TaskID: 

123 

PathID: 

1234 

InputName: 

Question 1 input 

InputDesc: 

Distinct input for Question 1 


ReferenceNam 

e: 

uisiinctjnpui 

TutorAware: 

True 

oourceiierriiu 


TargetID: 

4001 

Row: 

2 

Column: 

3 

SheetName: 

Sheetl 


The Row, Column and SheetName are filled in once the user clicks "Run Inputs/Outputs". The simulation engine 
decodes the defined name (Reference Name) that the designer entered, and populates the table accordingly. This is an 
important step. We had several occasions when a designer would change the layout of a spreadsheet, i.e., move a defined name 
location, then forget to perform this step. As such, bizarre data was being passed to the tutor; whatever data happened to reside 
in the old row and column. Once the configuration is completed, the designer can now utilize the ICA Utilities to test the 
simulation. 

The drag & drop input consist of two consecutive spreadsheet cells. Both of them have to be filled by the designer at 
design time or by the GBS application at run time via the simulation engine object's methods. This type of input is used usually 
when the user must choose one answer among a selection of possible answers. Drag & drop inputs are always TutorAware. The 
left most cell contains the SourceltemID of the answer picked by the user (every possible answer needs a SourceltemlD) and 
the rightmost cell can contain a numeric value associated to that answer. You need to define a name or ReferenceName in the 
spreadsheet for the rightmost cell. ICA will be notified of any changes to either one of the ceils. When the ICA is notified of a 
change two messages are in fact sent to the ICA: An ICANotifyDestroy message with the input information i.e., SourceltemID 
before the change occurred, TargetID of the input and the Attribute value before the change occurred. An ICANotifyCreate 
message with the input information i.e., SourceltemID after the change occurred, TargetID of the input and the Attribute value 
after the change occurred. 

These are the steps required to configure that section of the simulation: Define a name for cell C1 1 in Excel. Here we 
have defined "DragDropJnput"; Let's use the same TaskID as before since Question 2 is part of the same simulation as 
Question 1. Ex: TaskID is 123; In the ICA, define a Target for the input. Ex: a TargetID of 4002 is generated by the ICA; In the 
ICA, define a Sourceltem for every possible answer to the question. Ex: SourceltemlDs 1202 to 1205 are generated by the ICA; 
Associate the input to a path (refer to Path object discussion); and Add the information in the Input table of the simulation engine 
database. A record in the Input table in accordance with a preferred embodiment is presented below. 


InputID: 

12346 

TaskID: 

123 

PathID: 

1234 

InputName: 

Question 2 input 

InputDesc: 

Drag & Drop input for Question 2 
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ReferenceNam 

e: 

DragDropJnput 

TutorAware: 

True 

SourceltemID 

ri *** 
u 

TaraetlD" 

4002 

Row: 

11 

Column: 

3 

SheetName: 

Sheetl 


The list object consists of one cell identifying the list (cell #1) and a series of placeholder rows resembling drag & drop 
inputs (cells #1.1 - 1.n to cells #n.1- n.n). The list is used usually when the user must choose multiple elements among a 
selection of possible answers. Cell #1 must have a uniquely defined name also called the list name. Cells #1.1 to #n.1 can 
contain the SourceltemID of one possible answer picked by the user (every possible answer needs a SourceltemID). The content 
of these cells must follow this format : -ListName-SourceltemlD. Cells #1.2 to #n,2 will hold the numeric value (attribute) 
associated with the SourceltemID in the cell immediately to the left. Cells #1.3-1 .n to #n.3 - n.n are optional placeholders for 
data associated with the answer. KEY NOTE: When implementing a list object the designer must leave all the cells under #n.1 to 
#n.n blank because this range will shift up every time an item is removed from the list. 


Every list has the following interface: 


Field Name 

Data 
Type 

Description 

ListID 

long 

Primary Key for the table 

TaskID 

long 

TaskID of the task associated with the list 

PathID 

long 

PathID of the path associated with the list 

ListName 

string*50 

Name of the list 

ListDesc 

string*25 
5 

Description of the list 

ReferenceNam 

e 

string*50 

Name of the spreadsheet cell associated with the list 

TutorAware 

boolean 

Whether the ICA should be notified of any changes to the list 

TargetID 

long 

TargetID of the output 

TotalColumns 

long 

Total number of data columns 

Row 

long 

Spreadsheet row number of the output -> speed optimization 

Column 

long 

Spreadsheet column number of the output -> speed 
optimization 

SheetName 

string*50 

Sheet name were the input is located -> speed optimization 
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Use of a list is demonstrated by continuing our math test. The math question in this example invites the user to select 
multiple elements to construct the answer. These are the steps required to configure that section of the simulation. Figure 26 
illustrates the steps for configuring a simulation in accordance with a preferred embodiment. Define a name for cell C23 in Excel. 
Here we have defined TheJJsf . Let's use the same TaskID as before since Question 3 is part of the same simulation as 
Question 1 and 2. Ex: TaskID is 123. In the ICA, define a Target for the list. Ex; a TargetID of 4006 is generated by the ICA. In 
the ICA, define a Sourceltem for every item that could be placed in the list. Ex: the following SourceltemlDs 1209, 1210, 1211, 
1212, 1213, 1214 are generated by the ICA. Associate the list to a path (refer to Path object discussion). Add the information in 
the List table of the simulation engine database. 

A record in the List table in accordance with a preferred embodiment is 


presented in the table appearing below. 


ListID: 

12346 

TaskID: 

123 

PathID: 

1234 

ListName: 

Question 3 list 

ListDesc: 

List for Question 3 

ReferenceNam 

e: 

TheJJst 

TutorAware: 

True 

TargetID: 

4006 

TotalColumns: 

1 

Row: 

23 

Column: 

3 

SheetName: 

Sheetl 


All cells in the spreadsheet that are result of calculations (do not require any external input) can be represented by 
output objects. Every output has an interface as outlined in the table below. 


Field Name 

Data 
Type 

Description 

OutputID 

long 

Primary Key for the table 

TaskID 

long 

TaskID of the task associated with the output 

PathID 

long 

PathID of the path associated with the output 

OutputName 

string*50 

Name of the output 

OutputDesc 

string*25 
5 

Description of the output 

ReferenceNam 

e 

string*50 

Name of the spreadsheet cell associated with the output 

TutorAware 

boolean 

Whether the ICA should be notified of any changes to the 




output 

SourceltemID 

long 

SourceltemID of the output 

TargetID 

long 

TargetID of the output 

Row 

long 

Spreadsheet row number of the output -> speed 
optimization 

ooiumn 

long 

Qnroorlchoot ^nhimn numhor rtf thp mitmit — ^ cnPPfl 
OprcdUbllCCl (AJIUIiHI MUMIUOl VI UIC UUlpUl ~ 0|JCGU 

optimization 

SheetName 

string*50 

Sheet name were the input is located -> speed 
optimization 


All this information is stored for every output in the Output table of the simulation database (ICASim.mdb). When 
designers construct their simulation model, they must be aware of the fact that there is only 1 type of Outputs : the Distinct 
Output. A Distinct Output consists of one and only one spreadsheet cell that contains a formula or a result of calculations. The 
existence of Output cells is the main reason to have a simulation model. If the cell is TutorAware, the ICA will be notified of any 
changes to the cell when all outputs are processed otherwise the ICA will be unaware of any changes. When the ICA is notified 
of a change two messages are in fact sent to the ICA: An ICANotifyDestroy message with the output information i.e., 
SourceltemID, TargetID and null as Attribute. This message is to advise the ICA to remove this information from its memory. An 
ICANotifyCreate message with the output information i.e., SourceltemID, TargetID, Attribute (cell numeric value) . This message 
is to advise the ICA to add this information to its memory. As opposed to Distinct Inputs and Drag & Drop Inputs which notify the 
ICA on every change, Distinct Outputs are processed in batch just before asking the ICA for feedback. To notify the ICA of the 
total dollar amount of the items in the list. We definitely need a Distinct Output for that. The output will contain a sum formula. 
Define a name for cell C24 in Excel. Here we have defined B Distinct_Output".Let's use the same TaskID as before since Question 
3 is part of the same simulation as Question 1 and 2. Ex: TaskID is 123. In the ICA, define a Target for the output. Ex: a 
TargetID of 4005 is generated by the ICA. In the ICA, define a Sourceltem for the output. Ex: a SourceltemID of 1215 is 
generated by the ICA. Associate the output to a path (refer to Path object discussion). 
Add the information in the Output table of the simulation engine database. 

A record in an Output table in accordance with a preferred embodiment is presented below. 


OutputID: 

12347 

TaskID: 

123 

PathID: 

1234 

OutputName: 

Question 3 output 

OutputDesc: 

Distinct Output for Question 3 

ReferenceNam 

e: 

Distinct_Output 

TutorAware: 

True 

SourceltemID 

1215 

TargetID: 

4005 


Row: 

24 

Column: 

6 

SheetName: 

Sheetl 


Paths are used to divide a simulation model into sub-Simulations meaning that you can group certain inputs, outputs 
and lists together to form a coherent subset or path. Every path has the following interface: 


Field Name 

Data 

Type 

Description 

PathID 

long 

Primary Key for the table 

TaskID 

long 

TaskID of the task associated with the path 

PathNo 

long 

Numeric value associated to a path 

PathName 

string* 

50 

Name of the path 

PathDesc 

string* 

255 

Description of the path 


All this information is stored for every path in the path table of the simulation database (ICASim.mdb). 


The simulation engine is the interface between the model, the simulation database and the Intelligent Coaching Agent. 
The simulation engine is of interest to the designer so that he can understand the mechanics of it all. But it is the developer of 
applications using the engine that should know the details of the interface (methods & properties) exposed by the engine and 
the associated algorithms. Once the designer has constructed the simulation model (Excel Spreadsheet) and configured all the 
inputs, outputs & lists, he is ready to test using the test bench included in the ICA Utilities (refer to ICA Utilities documentation). 
The developer, in turn, needs to implement the calls to the simulation engine in the GBS application he's building. The following 
list identifies the files that need to be included in the Visual Basic project to use the simulation workbench : 


wSimEng.ds 

Simulation Engine class 

wSimEng.bas 

Simulation Engine module (this module was introduced only for speed 
purposes because all the code should theoretically be encapsulated in the 
class) 

wConst.bas 

Intelligent Coaching Agent constant declaration 

wDeclare.bas 

Intelligent Coaching Agent DLL interface 

wlca.cls 

Intelligent Coaching Agent class 

wlca.bas 

Intelligent Coaching Agent module (this module was introduced only for 
speed purposes because all the code should theoretically be encapsulated 
in the class) 


To have a working simulation, a developer places code in different strategic areas or stages of the application. There's 
the Initial stage that occurs when the form containing the simulation front-end loads. This is when the simulation model is 
initialized. There's the Modification stages that take place when the user makes changes to the front-end that impacts the 
simulation model. This is when the ICA is notified of what's happening. There's the Feedback stage when the user requests 
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information on the work done so far. This is when the simulation notifies the ICA of all output changes. Finally, there's the Final 
stage when the simulation front-end unloads. This is when the simulation is saved to disk. 

The different stages of creating a simulation, including the Visual Basic code involved, are presented below. Initial 
stage- 1 Creating the ICA & the simulation engine object: Code: Set moSimEngine = New classSimEngine; Set molCA = 
New classICA; Description: The first step in using the simulation engine is to create an instance of the class dassSimEngine and 
also an instance of the class classICA. Note that the engine and ICA should be module level object "mo" variables. 2. Load.ng 
the simulation; Code: Ret = moSimEngine.O P enSimulation(App.Path & DIR.DATA & FILE_SIMULATION, 
Me bookSimulation); IRet = m oSimEngine.LoadSimu.ation(m.lCATasklD. App.Path & DIR.DATABASE & DB_SIMULATION, 1); 
Demotion: After the object creation, the (^Simulation and LoadSimulation methods of the simulation engine object must be 
called The OpenSimulation method reads the specified Excel 5.0 spreadsheet file into a spreadsheet control. The 
LoadSimulation method opens the simulation database and loads into memory a list of paths, a list of inputs, a list of outputs and 
a list of lists for the specific task. Every method of the simulation engine will return 0 if it competes successfully otherw.se an 
appropriate error number is returned. 3. Initializing and loading the Intelligent Coaching Agent; CodeJRet = 
molCA.Initialize(App.P a th & "\" & App.EXEName ft "ini", App.Path & DIR.DATABASE, App.Path & DIRJCADOC. App.Path & 
T)- IRet = moICA LoadTask(mllCATasklD, ICAStudentStartNew); Description: The simulation engine only works .n conjunction 
with the ICA The Initialize method of the ICA object reads the application .ini file and sets the Tutor32.dll appropriately. The 
LoadTask method tells the ICA (Tutor32.dll) to load the .tut document associated to a specific task in memory. From that pent 
on the ICA can receive notifications. Note: The .tut document contains all the element and feedback structure of a task. Ex: 
SourcePages. Sourceltems, TargetPages. Targets, etc.4. Restoring the simulation; Code,«Code to reset the simulation 
when starting over»; «Code to load the controls on the simulation front-end»; IRet - moSimEngine.RunlnputsfsPaths. True); 
IRet = moSimEngine.RunOutputs(sPaths, True); IRet = moSimEngine.RunLists(sPaths, True); Call molCA.Submit(0); Call 
moICA SetDirtyFlag(0. False); Description: Restoring the simulation involves many things: clearing all the inputs and hsts when 
the user is starting over; loading the interface with data from the simulation model; invoking the Runlnputs. RunOutputs and 
RunLists methods of the simulation engine object in order to bring the ICA to it s original state; calling the Submit method of the 
,CA object with zero as argument to trigger all the rules; calling the SetDirtyFlag of the ICA object .nth 0 and false as arguments 
in order to reset the user's session. Running inputs involves going through the list of TutorAware inputs and notifying the ICA of 
the SourceltemlD. TargetID and Attribute value of every input. Running lists involves going through the list of TutorAware l.sts 
and notifying the ICA of the SourceltemlD, TargetID and Attribute value of every item in every list. The TargetID is umque for 
every item in a list 

Running outputs involves going through the list of TutorAware outputs and notifying the ICA of the SourceltemlD. TargetID and 
Attribute value of every output. Modification stage 1. Reading inputs & outputs; Code^Dim sDataArray(2) as string; Dim 
attribute as variant; Dim ISourceltemID as long; Dim ITargetID as longJRet = moSimEngine.ReadReferenceCDistinctJnpuf . 

vAttribute, ISourceltemID, ITargetID, sDataArray) 

Demotion- The ReadReference method of the simulation object will return the attribute value of the input or output 
referenced by name and optionally retrieve the SourceltemlD. TargetID and related data. In the current example, the attnbute 
value, the SourceltemlD, the TargetID and 3 data cells will be retrieved for the input named Distinctjnput. 

Description: The simulation engine object provides basic functionality to manipulate lists. 

The ListAdd method appends an item(SourceltemlD. Attribute. Data array) to the list. Let's explain the algorithm. F,rst, 
we find the top of the list using the list name. Then, we seek the first blank ce„ underneath the top cell. Once the destination ,s 
determine the data is written to the appropriate cells and the ICA is notified of the change.The ListCount method returns the 


AND1P0U 

-36- 


number of items in the specified list. The algorithm works exactly like the ListAdd method but returns the total number of items 
instead of inserting another element.The ListModify method replaces the specified item with the provided data. Let's explain the 
algorithm. First, we find the top of the list using the list name. Second, we calculate the row offset based on the item number 
specified. Then, the ICA is notified of the removal of the existing item. Finally, the data related to the new item is written to the 
appropriate cells and the ICA is notified of the change. The ListDelete method removes the specified item. The algorithm works 
exactly like the ListModify method but no new data is added and the cells (width of the list set by Total Columns') are deleted 
with the 'move cells up' parameter set to true. Keep this in mind, as designers often enter the wrong number of columns in the 
Total Columns parameter. When they overestimate the Total Columns, ListDelete will modify portions of the neighboring list, 
which leads to erratic behavior when that list is displayed. 


SYSTEM DYNAMICS IN ACCORDANCE WITH A PREFERRED EMBODIMENT 

To use system dynamics models in the architecture, an engine had to be created that would translate student work into 
parameters for these models. A complex system dynamics model to interact with an existing simulation architecture is discussed 
below. The system dynamics model provides the following capabilities.Allow designers to build and test their system dynamics 
models and ICA feedback before the real interface is built.Reduce the programming complexity of the activities.Centralize the 
interactions with the system dynamics models.System Dynamics Engine As with the simulation engine, the designer models the 
task that he/she wants a student to accomplish using a Microsoft Excel spreadsheet. Here, however, the designer also creates a 
system dynamics model (described later). The system dynamics engine will read all of the significant cells within the simulation 
model (Excel) and pass these values to the system dynamics model and the ICA. After the system dynamics model runs the 
information, the output values are read by the engine and then passed-to the simulation model and the ICA. 

Figure 27 is a block diagram presenting the detailed architecture of a system dynamics model in accordance with a 
preferred embodiment. Once the simulation model, system dynamics mode! and feedback are completely tested by designers, 
developers can incorporate the spreadsheet in a graphical user interface, e.g., Visual Basic as a development platform. Figure 
27 illustrates that when a student completes an activity, the values are passed to the system dynamics engine where the values 
are then passed to the system dynamics model (as an input), written to the simulation model and submitted to the ICA. When the 
system dynamics model is played, the outputs are pulled by the engine and then passed to the simulation model and the ICA. 
Note that the simulation model can analyze the output from the system dynamics model and pass the results of this analysis to 
the ICA as well. The simulation model can then be read for the output values and used to update on-screen activity controls 
(such as graphs or reports).lt is very important that all modifications that the ICA and system dynamics model need to know 
about go through the engine because only the engine knows how to call these objects. This significantly reduces the skill level 
required from programmers, and greatly reduces the time required to program each task. In addition, the end-product is less 
prone to bugs, because the model and tutor management will be centralized. If there is a problem, only one section of code 
needs to be checked. Finally, since the engine loads the data from the spreadsheet, the chance of data inconsistency between 
the ICA, the system dynamics model and the application is insignificant. 

The system dynamics model generates simulation results over time, based on relationships between the parameters 
passed into it and other variables in the system. A system dynamics object is used to integrate with Visual Basic and the 
spreadsheet object. The object includes logic that controls the time periods as well as read and write parameters to the system 
dynamics model. With Visual Basic, we can pass these parameters to and from the model via the values in the simulation object. 
The system dynamics object also controls the execution of the system dynamics model. What this means is that after all of the 
parameter inputs are passed to the system dynamics model, the engine can run the model to get the parameter outputs. The 


system dynamics object allows for the system dynamics models to execute one step at a time, all at once, or any fixed number of 
time periods. When the system dynamics model runs, each step of the parameter input and parameter output data is written to a 
'backup' sheet for two reasons. First, the range of data that is received over time (the model playing multiple times) can be used 
to create trend graphs or used to calculate statistical values. Second, the system dynamics model can be restarted and this audit 
trail of data can be transmitted into the model up to a specific point in time. What this means is that the engine can be used to 
play a simulation back in time. When any event occurs within the system dynamics engine, a log is created that tells the 
designers what values are passed to the simulation model, system dynamics model and ICA as well as the current time and the 
event that occurred. The log is called "SysDyn.log" and is created in the same location as the application using the engine. As 
with the spreadsheet object, the system dynamics object allows a large amount of the calculations to occur in the system 
dynamics model and not in the activity code, again placing more control with the activity designers. Model objects are used to 
configure the system dynamics models with regard to the time periods played. Models are what the parameter inputs and 
parameter outputs (discussed later) relate to, so these must be created first. Every model has the following application 
programming interface: 


Field Name 

Data 

Type 

Description 

ModellD 

Long 

Primary Key for the table 

TaskID 

Long 

TaskID of the task associated with the model 

ModelName 

String* 

50 

Name of the model (informational purposes) 

ModelDesc 

String* 

50 

Description of the model (informational purposes) 

SysDynModel 

String* 

50 

Filename of the actual system dynamics model 

Start 

Long 

Start time to play modal 

Stop 

Long 

Stop time to play model 

Step 

Long 

Interval at which to play one model step and record 

data 


This information is stored in the model table of the simulation database (ICASim.mdb). Al! of the values that will need to 
be manually entered by the student that are passed into the system dynamics model are configured as parameter inputs 
(Plnputs) objects. Every Plnput has an interface as detailed below. 


Field Name 

Data Type 

Description 

PinputID 

long 

Primary Key for the table 

TaskID 

long 

TaskID of the task associated with the parameter input 

ModellD 

long 

ID of the model associated with the parameter input 

InputName 

string*50 

Name of the parameter input (informational purposes) 

InputDesc 

string*255 

Description (informational purposes) 
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ReferenceName 

string*50 

Name of the spreadsheet cell a ssociated with the 
parameter input 1 

SimReferenceName 

string*50 

Name of the associated parameter in the system 
dynamics model 

TutorAware 

boolean 

Whether the ICA should be notified of any input 

UnAINvjto 

SourceltemID 

ong 

oourceitemiu ot me parameter input 

i 01 yciiL/ 


TaraetlD of the Darameter incut 

Row 

long 

Spreadsheet row number of the parameter input 

Column 

long 

Spreadsheet column number of the parameter input 

SheetName 

string*50 

Sheet name were the parameter input is located 


All of this information is stored for every parameter input in the Plnput table of the simulation database (ICASim.mdb). 
Plnputs consist of one spreadsheet cell that can be populated by a designer at design time or by the GBS application at run time 
via the system dynamics engine object's methods. The purpose of the cell is to provide an entry point to the simulation and 
system dynamics models. An example of an entry point would be the interest rate parameter in the interest calculation example. 
The ICA is notified of any changes to the cell when an appropriate activity transpires. When the ICA is notified of a change two 
messages are sent to the ICA. The first is an ICANotifyDestroy message with the parameter input information i.e., SourceltemID, 
TargetlD and null as an attribute. This message is sent to inform the ICA to remove information from its memory. The second 
message is an ICANotifyCreate message with the parameter input information i.e., SourceltemID, TargetlD, Attribute (cell 
numeric value). This message advises the ICA to add this information to its memory. A Plnput table record in accordance with a 
preferred embodiment is presented below. 


PlnputlD: 

12345 

TaskID: 

123 

ModellD: 

1 

InputName: 

Interest Rate input 

InputDesc: 

Interest Rate input into interest 
calculation model 

ReferenceName: 

lnterest_Rate 

SimReferenceNam 

e 

Param_lnterest_Rate 

TutorAware: 

True 

SourceltemID 

\1201 

TargetlD: 

4001 

Row: 

6 

Column: 

3 
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SheetName: 


Sheetl 


Once the configuration is completed, the designer can also use the ICA Utilities to test the simulation. The Row, 
Column and SheetName values are automatically populated when the designer runs the parameters in the System Dynamics 
Workbench in the ICA Utilities. The following information provides details describing the interaction components in accordance 
with a preferred embodiment. 


Title 

Description 

Procedural tasks (w/drag 

drop) 

Tasks which require the construction of some kind of report with evidence 
dragged and dropped to justify conclusions 

Procedural tasks (w/o drag 

drop) 

New task designs that are procedural in nature, have very little branching, and 
always have a correct answer. 

ninn Dnnn ta^k 
L/ii iy L/uiiy iQoi\ 

Tasks that interrupt the student while working on something else. This template 
includes interviewing to determine the problem, and a simple checkbox form to 
decide how to respond to the situation. 

Analyze and Decide (ANDIE) 

task 

Most commonly used for static root cause analysis, or identification tasks. 
Developed on SBPC as a result of 3 projects of experience redesigning for the 
same skill. 

Evaluate Options (ADVISE) 

Used for tasks that require learner to evaluate how different options meet stated 
goals or requirements. Developed at SBPC after 4 projects experience 
redesigning for the same skill. Does not allow drag drop as evidence. 

Run a company task 

Time based simulation where student "chooses own adventure". Each period the 
student selects from a pre-determined list of actions to take. Developed on SBPC 
as a simplified version of the BDM manage task. 

Use a model task 

When user needs to interact with a quantitative model to perform what if 
analysis. May be used for dynamic root cause analysis - running tests on a part 
to analyze stress points. 

iL/A uynamic Meeting i asi\ 

nowolnnoH rtn RHM tn mtmip intprartinn <;tvlp^ frnm P.nsph flnii It S FPA 

L/CvClUUcU UM DUIVi IU II HI Mil* II 11CI aL»UUI 1 OljICO ULNII wUOUM CM lu %\-\J i— I r~i. 

Supports dynamic-rule based branching - will scale to support interactions like 
EnCORE defense meetings and YES. 

Manage Task 

Time based simulation where student manages resources. Human Resources 
Management, managing a budget, manage an FX portfolio. 

QVID Static Meeting Task 

Developed on Sim2 to support agenda-driven meetings where user is presented 
with up to 5 levels of follow-up questions to pursue a line of questioning. As they 
ask each question, it's follow-ups appear. 

Flow Chart Task 

Will support most V1SIO diagrams. Developed on Sim2 to support simple flow 
chart decision models. 
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QVID Gather Data 
Component 

Static fiat list of questions to ask when interviewing someone. Not used when 
interviewing skills are Demg taugnt (use uviu static meeting iasK;. oupporib 

hiprarrhiral nup^tinn^ anri timpri tran^criots 

1 HOf CU wl lll/GI UUC9UUI lO Ol IU Ullldf U Cll lOwl ipitj. 

Journalize Task 

Created to support simple journal entry tasks with up to 2 accounts per debit or 
credit. 

New Complex Task 

A new task that requires a simulation component 


The system dynamics engine is the interface between the simulation model, the system dynamics model, the simulation 
database and the Intelligent Coaching Agent. The system dynamics engine is of interest to the designer so that she can 
understand the mechanics of it. Once the designer has constructed the simulation mode! (Excel Spreadsheet), built the system 
dynamics model (PowerSim) and configured all of the parameter inputs and parameter outputs, a test can be performed using 
the workbench included in the ICA Utilities (refer to ICA Utilities documentation). The developers, in turn, need to implement the 
calls to the system dynamics engine in the GBS application that is being built. The following list identifies the files that need to be 
included in the Visual Basic project to use the system dynamics engine. 


WSysDynEng.cIs 

System dynamics Engine class 

wSysDynEng.bas 

System dynamics Engine module (this module was introduced only for speed 
purposes because all the code should theoretically be encapsulated in the 
class) 

wConstbas 

Intelligent Coaching Agent constant declaration 

wDeclare.bas 

Intelligent Coaching Agent DLL interface 

wtca.cls 

Intelligent Coaching Agent class 

wlca.bas 

Intelligent Coaching Agent module (this module was introduced only for 
speed purposes because all of the code should theoretically be encapsulated 
in the class) 


To utilize the system dynamics engine fully, the developer must place code in different strategic areas or stages of the 
application. Initial stage - the loading of the form containing the simulation front-end. This is when the simulation model and 
system dynamic engine are initialized. Modification stage - Takes place when the user makes changes to the front-end that 
impacts the simulation model Plnputs). This is when the ICA is notified of what's happening. Run stage - The system dynamics 
model is run and parameter outputs are received. Feedback stage - The user requests feedback on the work that they have 
performed. This is when the simulation notifies the ICA of all output changes. Final stage - The simulation front-end unloads. 
This is when the simulation model is saved. These stages will be explained by including the Visual Basic code involved as well as 1 
a short description of that code. 

Initial Stage Code In Accordance With A Preferred Embodiment 

1. Creating the ICA & the simulation engine objects: Code: Set moSysDynEngine = New classSysDynEngine; Set 
moICA = New classICA; Description: The first step in using the system dynamics engine is to create an instance of the 
classSysDynEngine class and also an instance of the classICA class. Note that the engine and ICA should be module level 
object a mo n variables. 2. Loading the simulation: Code: IRet = moSysDynEngine.OpenSimulation(FILE_S1M, Me.bookSim, 
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True); IRet = moSysDynEngine.LoadSysDynfmllCATaskID, DB.SIMULATION, 1); IRet = 

moSysDynEngineloadModel(MODEL_NAME ( mbTaskStarted); Description: After the object creation, the OpenSimulation, 
LoadSimulation and LoadModel methods of the system dynamics engine object must be called. The OpenSimulation method 
reads the specified Excel 5.0 spreadsheet file (FILE_SIM) into a spreadsheet control (bookSim). The LoadSysDyn method opens 
5 the simulation database (DB_SIMULATION) and loads into memory a list of parameter inputs and a list of parameter outputs. 
The LoadModel method opens a system dynamics model (MODELJMAME). Every method of the system dynamics engine will 
return 0 if it completes successfully otherwise an appropriate error number is returned. 3. Initializing and loading the 
Intelligent Coaching Agent; Code: IRet = molCA.Initialize(App.Path & "V & App.EXEName & ".ini", App.Path & 
DIR.DATABASE, App.Path & DIRJCADOC, App.Path & T); IRet = molCA!oadTask(mllCATasklD, ICAStudentStartNew); 
10 Description: The system dynamics engine only works in conjunction with the ICA. The Initialize method of the ICA object reads 
the application .ini file and sets the Tutor32.dll appropriately. The LoadTask method tells the ICA (Tutor32.dll) to load the .tut 
document associated to a specific task in memory. From that point on, the ICA can receive notifications. Note: The .tut 
document contains all the element and feedback structure of a task. Ex: SourcePages, Sourceltems, TargetPages, Targets, 
etc... 4. Restoring the simulation- Code: IRet = moSysDynEngine.RunPlnputs(MODEL_NAME, True); IRet = 
15 moSysDynEngine.RunPOutputs(MODEL_NAME, True); IRet = moSysDynEngine.PassPlnputsAII; Call molCA.Submit(0); Call 
'% molCA.SetDirtyFlag(0 ( False) Description: Restoring the simulation involves many things: clearing all of the parameter inputs 

51 and outputs when the user is starting over; loading the interface with data from the simulation model; invoking the PassPlnputsAII 

ffl method of the system dynamics engine object in order to bring the ICA to its original state; invoking the RunPlnputs and 

il RunPOutputs methods of the system dynamics engine object in order to bring the system dynamics model to it's original state; 

20 calling the Submit method of the ICA object to trigger the ICA to play all of the rules; calling the SetDirtyFlag of the ICA object to 
§£? reset the user's session. Running parameters involves going through the list of TutorAware Plnputs and POutputs and notifying 

the ICA of the SourceltemID, TargetID and Attribute value of every one.Modification Stage; 1 . Reading parameter inputs & 
3\ outputs; Code: Dim sDataArray(2) as string; Dim vAttribute as variant; Dim ISourceltemlD as long, ITargetID as longJRet = 

J moSysDynEngine.ReadReferenceflnpuLName", vAttribute, ISourceltemlD, ITargetID, sDataArray). Description: The 

25 ReadReference method of the system dynamics object will return the attribute value of the parameter input or output referenced 
U l - by name and optionally retrieve the SourceltemID, TargetID and related data. In the current example, the attribute value, the 

SourceltemID, the TargetID and 3 data cells will be retrieved for the parameter input named InputJMame, 
2. Modifying parameter inputs Code: Dim vAttribute as variant; Dim ISourceltemlD as long; Dim sDataArray(2) as string; 
vAttribute=9999; sDataArray(0)= n Data Cell #1"; sDataArray(1)="Data Cell #2"; sDataArray(2)="Data Cell #3"; IRet = 
30 moSysDynEngine.WriteReference(1nput_Name B , vAttribute, , sDataArray). Description: To modify a parameter input, call the 
WriteReference method of the system dynamics object and pass the Plnput reference name, the new attribute value and 
optionally a data array (an additional information to store in the simulation model). The system dynamics engine notifies the ICA 
of the change. Run Stage 1. Playing the System Dynamics Model; Code: IRet = 

moSysDynEngine.PlayModel(SYSDYN_PLAYSTEP); IblCurrentTime.Caption = moSysDynEngine.CurrentTime; and 
35 IblLastTime.Caption = moSysDynEnginelastTime; Description: Playing the system dynamics model is also handled by the 

system dynamics engine. There are three ways that the models can be played, all at once, one step at a time (shown above) or 
until a specific point in time. These are the parameters that are passed into the PlayModel method. Playing of the model 
generates the parameter output values and passes the Tutor Aware POutputs to the ICAT. The engine also keeps track of time 
and these values can be read using the CurrentTime and LastTime properties. 2. Jumping Back in a System Dynamics 
40 Model Code: IRet = molCA.LoadTask(mllCATasklD, ICAStudentStartNew); IRet - 
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moSysDynEngine. JumpBack(TiME_TOJUMP_TO). Description: Because the system dynamics engine writes backup copies 
of the parameters passed to and from it, it can start over and resubmit these values back to the system dynamics model until a 
given period of time. To do this, the code would need to restart the ICA and then call the system dynamics engine to jump back 
to a given time (TIME_TO_JUMP_TO). Feedback stage 1. Triggering the ICA Rule engine; Code: IRet= 
molCA.Submit(ICoach!D); Description: Once the simulation has been processed, the Submit method of the ICA object must be 
called to trigger all the rules and deliver the feedback. This feedback will be written by the Tutor32.dll to two RTF formatted files. 
One file for previous feedback and one file for the current feedback. 

ICA Configuration in Accordance with a Preferred Embodiment 

Figure 28 is an overview diagram of the logic utilized for initial configuration in accordance with a preferred 
embodiment. Since the structure of the feedback is the same as other on-line activities, the ICA can also be configured in the 
same manner. For ease of creation and maintenance of ICA feedback, it is recommended that the feedback is constructed so 
that only one rule fires at any point in time. Note that the organization of the example is one of many ways to structure the 
feedback. Step 1: Create a map of questions and follow-up questions; Before designers start configuring the ICA, they should 
draw a map of the questions, videos and follow-up questions that they wish to use in the on-line meeting. This will give them a 
good understanding of the interactions as they configure the ICA. Step 2: Create a coach; All feedback is given by a coach. 
Create a specific coach for the on-line meeting. Step 3: Create the Source Items and Targets 

Every question will have one Source Item (1) and Target (2) associated with it. These will be used by the ICA to show 
videos and follow-up questions. For organizational purposes and ease of reading, it is recommended that each Source Page ("0 
Intro") contain all of the follow up questions ("Intro Qf, "Intro Q2 n , "Intro Q3"). Targets can be created one per Source Item 
(shown here) or one per many Source Items. This is not very important, so long as there are distinct Source Item and Target 
associations. Once the Source Items and Targets have been created, associate them into SourceltemTargets (3) and give them 
a relevance of one. These are the unique identifiers which the ICA will use to fire rules and to provide feedback to the student. 
Step 4: Create the Parent Header (Video Information) Figure 29 is a display of video information in accordance with a preferred 
embodiment. Feedback (Coach Items) are organized into Target Groups (1). In Figure 29, each on-line question has one Target 
Group for ease of maintenance. Each TargetGroup must have at least one related Target (4). These are the SourceitemTarget 
mappings that were made at the end of Step 3. Next, Rules (2) are created to fire when the SourceitemTarget is mapped (a 
question is clicked). Coach Items (3) are associated to a rule and represent the feedback which will be shown if the rule is fired. 
The ICA Utilities incorporate business simulation into a multimedia application. What this means is that there is now a middle 
layer between the application and the ICAT. These utilities, along with the simulation engine (described later), allow the 
architecture to be a front end to the simulation. Now, any changes to a simulation model do not need to be incorporated into 
code. The ICA Utilities and simulation engine work with simulation models created in Microsoft Excel. After the model is created, 
the designer uses the Defined Name function in Excel to flag specific cells that are to be used by the application and the ICA 
Utilities in accordance with a preferred embodiment. Figure 30 illustrates an ICA utility in accordance with a preferred 
embodiment. The ICA Utilities consist of six utilities that work with the Intelligent Coaching Agent Tool (ICAT) to incorporate 
business simulation with the multimedia application. 


